Подать заявку

С вами кто-то свяжется в ближайшее время

Оставьте заявку на подключение

Ваша заявка принята в обработку. Вам ответят на электронную почту в рабочем порядке.

Спасибо за обращение

Создать сайт

Tilda — это один из конструкторов, с помощью которого можно собрать свой сайт из готовых блоков

Создайте сайт на <a>Tilda</a>

Подробнее

Придите в филиал АО «Народного банка Казахстана» и менеджер поможет Вам подписать договор

Подпишите <span>договор</span>

<span>Быстрый старт</span> вашего интернет - магазина, без навыков программирования

Мы подготовили для вас подробную инструкцию

Видеоинструкция

Когда сайт готов и договор подписан, необходимо подключить модуль к Вашему сайту

Подключите модуль <span>ePay</span>

# API
## Oauth

>> URL test https://testoauth.homebank.kz/epay2  
>> URL prod https://epay-oauth.homebank.kz

[Получение токена](https://developer.homebank.kz/epay/api/poluchenie-tokena)  
[Обновление токена](https://developer.homebank.kz/epay/api/obnovlenie-tokena)  
[Отзыв токена](https://developer.homebank.kz/epay/api/otzyv-tokena)  

## API

>> URL test https://testepay.homebank.kz/api

>> URL prod https://epay-api.homebank.kz

* [Отмена платежа](https://developer.homebank.kz/epay/api/cancel)  
* [Подтверждение/Частичное подтверждение](https://developer.homebank.kz/epay/api/podtverzhdenie-chastichnoe-podtverzhdenie-operacii)  
* [Возврат/Частичный возврат](https://developer.homebank.kz/epay/api/vozvrat-chastichnyi-vozvrat)

# Платеж через API
**Для работы через API компании необходимо наличие сертификации PCI DSS**

При регистрации вам будут выданы данные, которые нужно будет использовать при проведении платежа:

- TerminalID – идентификатор магазина
- ClientID – идентификатор клиента
- ClientSecret – секретный ключ

## Данные для проведения тестовых платежей: 
|            |         | 
| ---------- | ---------- |
| url       | https://test-epay.homebank.kz   |
| email       | epay@halykbank.kz     |
| password       | XZG1E@Mm       |
| ClientID       | test       |
| ClientSecret       | yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG     |
| TerminalID       | 67e34d63-102f-4bd1-898e-370781d0074d       |

### Test payment card

| PAN                  | Expire Date   | CVC  | Status |
| -------------------- | ------------- | ---- | ------ |
| 4405639704015096     | 01/25         | 815  | unlock |
| 5522042705066736     | 01/25         | 525  | unlock |
| 377514500004820      | 01/25         | 4169 | lock |
| 4003032704547597     | 09/20         | 170  | lock   |
| 5578342710750560     | 09/20         | 254  | lock   |

## Получение токена для проведения оплаты (для каждой операции необходимо получать и использовать оригинальный токен)

```
TEST URL POST https://testoauth.homebank.kz/epay2/oauth2/token
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token
```

### Запрос

```
grant_type: "client_credentials"
scope: "webapi usermanagement email_send verification statement statistics payment"
client_id: "ClientID"
client_secret: "ClientSecret"
invoiceID: "Номер заказа"
amount: 100
currency: "KZT"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"

```

### Ответ

```
{
  "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
  "expires_in": 7200,
  "scope":"webapi usermanagement email_send verification statement statistics payment",
  "token_type":"Bearer"
}
```

## Входящие параметры

| Название поля | описание | Обязательное/не обязательно |
| -------- | -------- | -------- |
| amount | сумма платежа | обязательное |
| currency| валюта |  обязательное  |
| name | имя держателя карты |  обязательное  |
| сryptogram | закриптованные параметры платежной карты |  обязательное  |
| invoiceId     | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр. Если ваш номер заказа содержит более 6 символов, то дополнительно уникальность должна соблюдаться по последним 6ти символам | обязательное  |
| invoiceIdAlt     | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр.  | необязательно  |
| description | В данном поле передается информация о товарах или услугах, за которые производится оплата | обязательное|
| accountId | Идентификатор клиента в системе коммерсанта или другой доп. параметр на усмотрение коммерсанта |  необязательно  |
| email  | email клиента | необязательное  |
| phone  | телефон клиента | необязательно  |
| postLink | Линк для отправки результата авторизации в магазин. |  обязательное  |
| failurePostLink | Линк для отправки неудачного результата авторизации либо информации об ошибке в магазин. |  необязательно  |
|  cardsave| параметр сохранение карты, true - сохранить карту, false - не сохранять, boolean type |  обязательное  |
|  data| дополнительное поле транслируется в отчете при заполнении |  необязательно  |

## Подготовка криптограммы

Структура криптограммы:
```
{
  hpan string
  expDate string
  cvc string
  terminalId string
}

пример:
{
 "hpan":"4003032704547597","expDate":"1022","cvc":"636","terminalId":"67e34d63-102f-4bd1-898e-370781d0074d"
}

```

Структура должна быть зашифрованна при помощи публичного RSA-ключа, который доступен по адресу
https://epay-api.homebank.kz/public.rsa
https://testepay.homebank.kz/api/public.rsa

## Проведение платежа

```
POST URL https://testepay.homebank.kz/api/payment/cryptopay
POST URL https://epay-api.homebank.kz/payment/cryptopay
```

### Запрос

Заголовок запроса:
```
Content-Type: application/json
Authorization: Bearer DCEB8O_ZM5U7SO_T_U5EJQ
```

Тело запроса:
```
{
  "amount":100,
  "currency":"KZT",
  "name":"JON JONSON",
"cryptogram":"UhYXAhYGeFA6srEVJ2V8Jtnnz6NzRwy8QDkCvEmJOcC6KyBP/Ce4SUM0A0My1zS1Iiur6AF0ajJwdi31EvrkRDBvzl2iLVKzvuAyusc5KuGpgxRhc6WXDhKkHV7J5Oew8uPMOfVbmXZ+Ypihos5ynSX7TnqQg1ImAmEISBxT+YU7jY68uxGhlehYMJ0lgS1Req4Z0BwCExBL2lwo05lmSMed69bEdBX552ue13zXjvTKIMrVj70hXIppXnxAE7haJfObuQzx2Ox+wM087kFPXfDX8Udlc6iRP2TxnRj7R1GnCTLvf3xlVU9ELzK+j91SPBQTvyEeyEvGMunjRch8lGXlogQreFSZmC5FUpfdfw6jYhl6lizUZYZzroN6/i5MILtV0US8zPFZTfozrCj8cvqw+J2W7yBywDiFoZG1teLDMIKIqTvkrmRL++Ji0psdHXl0z0ng/d0yTxzcBpPZ5V8VfNOexJJRZQUXBQqygAqqYninku/ls1NuTRMPeveyrgSMjQUVKU2W1izXdSreSdvaOio+1HJHNCZDwNn9yheTzbmuUsl5lhnsUGNT5gzMuYje8VfRYpsvG3Syz6nOijprG1wL3L/p5B/SZGrtaMMg/OdbD3mUWCSmat/V2v9RKHaeo5OHMnaVMTY5Tsqwa5JKBRP4ztRcjkjMRCBvS8c=",    
  "invoiceId":"000001",
  "invoiceIdAlt":"8564546",
  "description":"test payment",
  "accountId":"uuid000001",
  "email":"jj@example.com",
  "phone":"77777777777",
  "cardSave": true,
  "data": "{\"statement\":{\"name\":\"Arman     Ali\",\"invoiceID\":\"80000016\"}}",
  "postLink":"https://testmerchant/order/1123",
  "failurePostLink":"https://testmerchant/order/1123/fail"
}

```

## Результат успешной операции по оплате без 3DSecure

```

HTTP/1.1 200 OK

{
  "id":"7943816b-58a8-47f6-a11e-67b63c4228c7",
  "amount": 100,
  "amountBonus":0,
  "currency":"KZT",
  "invoiceID":"938290483290",
  "invoiceIdAlt":"8564546",
  "accountID":"uuid000001",
  "phone":"77777777777",
  "email":"jj@example.com",
  "description":"test payment",
  "reference":"114537489258",
  "intReference":"435G34G34534T546",
  "secure3D":no,
  "cardID":"111DFSDF-3F43-18V4-V34-ASD12342323",
  "language":"rus"
  "fee":0,
  "code":0,
  "status":"AUTH"
}
```

## Результат неуспешной операции по оплате 
```

HTTP/1.1 400 OK

{
"code": 487,
"message": " Not permitted to merchant",
"invoiceId": "8161284658525",
"id": "",
"reference": "",
"accountId": "uuid000001"
}

```

## Результат операции по оплате с 3DSecure

```
HTTP/1.1 200 OK

"id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "accountId": "uuid000001",
    "amount": 10,
    "amountBonus": 0,
    "currency": "KZT",
    "description": "test payment",
    "email": "jj@example.com",
    "invoiceID": "123456813",
    "invoiceIdAlt":"8564546",
    "language": "RU",
    "phone": "77777777777",
    "reference": "",
    "intReference": "",
    "secure3D": {
        "paReq": "eJxVUl1TozAU/SsMrx1JSFuXdm7jsFZ23dbKmrbO+hYhCrYEDEFrf70JC3683XPunXPuPQmcHYq98yJUnZdy5voedh0hkzLN5ePM3ayjk8A9o7DOlBBzJpJGCQpXoq75o3Dy258741Sm14EUXbV5dC26bQGVCjijqhWtTaMWcVhjLWlgL0ecr5bxtxok1q4QMLgrh4iaRaln8I44PX1cM+/DHJ5pkNvh2yVrlJjYzwaetlASArg7o3Rd03MNW37/EOlXHEpA==",
        "md": "271710719-E54F6D8F865285D4",
        "action": "https://cardsecure.kkb.kz/CommerSafeACS/pa?id=YLcP2547mFFVw"
    },
    "cardID": ""

```

После получения результата по оплате с 3DSecure необходимо переадресовать клиента на форму ввода пароля.

Для этого используются полученные параметры: paReq, md, action.

В параметре TermUrl необходимо использовать адрес, на который система мерчанта получит результат проверки 3DSecure. пароля.

Пример построения формы для перенаправления клиента:

```
<body  onload="javascript:OnLoadEvent();">
<FORM ACTION="<%=action%>" METHOD="post" NAME="ThreeDform" target="_self">
       <input name="PaReq" type="hidden" value="<%=paReq%>">
       <input name="MD" type="hidden" value="<%=md%>">
       <input name="TermUrl" type="hidden" value="https://merchantsite.com/3dRes">
</FORM>
       <div align="center"> 
                <h1>Дождитесь ответа! <br><br>
                     Жауабын күтіңіз!<br><br>
                     Wait for an answer!<br><br>                                                        
                </h1>
       </div>               
</body>
<SCRIPT>function OnLoadEvent () {
         document.forms[0].submit();
}

```
Результат проверки 3DSecure, получаемый на TermUrl мерчанта:

```
PaRes: eJzNWVnT4jiy/SsdPY9Et3ewO6gvQt53bPD+5g3vNmCDjX/9FXxV1TXVPXHnzsONIYJATqcyU0rlOZLYO+Utz/lTnt5v+cfeyMcxLvJfquzLrxY45tc/Qp0HJ6UBIXZEC3EqspDgx/nXj/3r9fhWfKv8dpgvVMRu/efRq2VFBVDlkd/Gaug/sN/R3/E98u0RermlZdxPH/s4vbKK+UGSKLWl9sjXx32X3xT+w1QcXbcEhsYIFKewPfIp3iN/9rfur9YII1+q7MM9CLyv42mIMwEpTXPmM13cLamyob/skZfGPoun/ANHcQylcPoXDP0DJf+gtnvkLd9fXuZAN9yhbYyBbtE98qNsD2fplvfp84Ng6D3y/WmfL5ehz6EGHOb39h75M7xL3H+gP3wwCmOgbSjdO8HHfqq6n8Ki/sChrbd8P07xdB8/H+vOG631x//574XXT/OPfDv8D83MUpA== MD: 270469967-9CA5EC5779A3358E 
```

Подтверждение платежа (отправка результата проверки 3DSecure пароля)

```
URL POST /payment/confirm
```

```
Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "271710719-E54F6D8F865285D4",
}
```

Response

Redirect Http code 200

Success https://epay.homebank.kz/payform/success.html Params amount currency invoiceID accountID description reference language cardid

Error https://epay.homebank.kz/payform/ invoiceID code message

Платеж через API

# Описания работы сервиса P2P по API

__Для работы через API компании необходимо наличие сертификации PCI DSS__

При регистрации вам будут выданы данные, которые нужно будет использовать при проведении перевода:

|            |            |
| ---------- | ---------- |
| TerminalID       | Идентификатор магазина |
| ClientID       | Идентификатор клиента |
| ClientSecret       | Секретный ключ |

__Тестовый коммерсант__
|            |            |
| ---------- | ---------- |
| URL        | https://test-epay.homebank.kz/login |
| email      | epay@halykbank.kz |
| password   | XZG1E@Mm       |
| ClientID   | test       |
| ClientSecret      | yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG     |
| TerminalID    | 40a348cb-68a3-45d5-9002-a4836d79c3b5 |

### Тестовые карты

| PAN                  | Expire Date   | CVC  | Status |
| -------------------- | ------------- | ---- | ------ |
| 4405639704015096     | 01/25         | 815  | unlock |
| 5522042705066736     | 01/25         | 525  | unlock |
| 377514500004820      | 01/25         | 4169 | unlock |
| 4003032704547597     | 09/20         | 170  | lock   |
| 5578342710750560     | 09/20         | 254  | lock   |

__Получение токена для проведения перевода__
```
TEST URL POST https://testoauth.homebank.kz/epay2/oauth2/token
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token
```

__Запрос__
Body: form-data

```
grant_type:     "client_credentials"
scope:          "transfer"
invoiceID:      "12321312312"
amount:         "100"
currency        "KZT"
client_id:      "test"
client_secret:  "yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG"
terminal:       "40a348cb-68a3-45d5-9002-a4836d79c3b5"

```

| Поле     | Описание     |
| ---------- | ---------- |
| grant_type       | тип авторизации, для проведения платежа используется тип авторизации: client_credentials  |
| invoiceID     | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр. Если ваш номер заказа содержит более 6 символов, то дополнительно уникальность должна соблюдаться по последним 6ти символам    |
| amount     | сумма     |
| currency     | валюта     |
| scope       | ресурс      |
| client_id       | Идентификатор коммерсанта, можно получить в кабинете, выдается при регистрации     |
| client_secret       | Ключ доступа коммерсанта, можно получить в кабинете, выдается при регистрации       |
| terminal     | Идентификатор точки продаж, можно получит в кабинете, выдается при регистрации      |

__Ответ__
 ```
    {
      "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
      "expires_in": 7200,
      "refresh_token":"",
      "scope":"transfer",
      "token_type":"Bearer"
    }

  ```

| Поле    | Описание     |
| ---------- | ---------- |
| access_token      | Токен для проведения операции       |
| expires_in       | Время истечения токена      |
| refresh_token     | Не используется при данном типе авторизации    |
| scope       | Ресурс, для проведения платежа используется ресурс transfer    |
| token_type      | Тип авторизации     |

После получения токена, необходимо передавать его в __Headers Bearer DCEB8O_ZM5U7SO_T_U5EJQ__ 

на эндпоинт: 
```
TEST URL https://testepay.homebank.kz/api/p2p/transfer
PROD URL https://epay-api.homebank.kz/p2p/transfer
```

метод POST, в теле запроса в формате JSON указывать след структуру: 

Body: raw

```
{
  "order": {
    "amount": 100,
    "currency": "KZT",
    "description": "TEST p2p",
    "merchantIdForSavingCards": "",
    "id": "123456787538",
    "senderIP": "",
    "senderEmail": "armanali@epay.kz",
    "foreign": false,
    "terminalId": "40a348cb-68a3-45d5-9002-a4836d79c3b5",
    "backLink": "https://epay.homebank.kz/demo/success.html",
    "failureBackLink": "https://epay.homebank.kz/demo/failure.html",
    "postLink": "https://epay.homebank.kz/payform",
    "failurePostLink": "https://testmerchant/order/1123/fail"
  },
  "card": {
    "sender": {
      "save": false,
      "transferType": "TYPEPAN",
      "address": "",
      "cvc": "815",
      "cardCred": "4405639704015096",
      "expire": {
        "month": "01",
        "year": "25"
      },
      "name": "Sergey Frolov",
      "number": ""
    },
    "receiver": {
      "save": false,
      "id": "",
      "transferType": "TYPEPAN",
      "cardCred": "5522042705066736"

    }
  }
}

```

__Описание полей отправителя sender:__

| Поле     | Описание     |
| ---------- | ---------- |
| Amount       | Сумма заказа       |
| currency       | Валюта       |
| description       | Описание заказа       |
| merchantIdForSavingCards       | Cell       |
| Id       | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр. Если ваш номер заказа содержит более 6 символов, то дополнительно уникальность должна соблюдаться по последним 6ти символам      |
| senderIP       | IP отправителя(не обязательно)     |
| senderEmail       | email клиента (не обязательно)      |
| Foreign       | false       |
| terminalId       | Идентификатор магазина       |
| backLink       | Ссылка для возврата в магазин при удачном платеже      |
| failureBackLink       | Ссылка для возврата в магазин при не удачном платеже      |
| postLink       | Уведомление о платеже      |
| failurePostLink       | Уведомление о неудачном платеже, если не заполнено, то информация будет отправлена на адрес указанный в postLink      |
| Save       | Сохранить карту – true, не сохранять - false      |
| transferType       | Тип проведения перевода, "TYPEPAN"  - по номеру карты, "TYPECARDID"  - по сохраненной карте epay|
| Address       | Адрес      |
| Cvc       | сvv      |
| Id       | передавать пустое значение     |
| Month       | месяц      |
| Year       | год      |
| Name       | Имя      |
| cardCred       | Номер карты отправителя/ id карты    |

__Описание полей получателя receiver__

| Поле     | Описание     |
| ---------- | ---------- |
| save       | Сохранить карту – true, не сохранять - false      |
| id       | cardid       |
| cardCred       | Номер карты получателя      |
| firstName       | Имя - только для переводов зарубеж     |
| lastName       | Фамилия - только для переводов зарубеж       |
| countryCode       | Код страны - только для переводов зарубеж   |

__Ответ в случае успеха:__

```

{
    "id": "a9e1b986-be01-4763-9216-610cc63b963c",
    "amount": 200,
    "currency": "KZT",
    "email": "epay@halykbank.kz",
    "description": "TEST p2p",
    "reference": "204978430339",
    "orderID": "1234567893774576",
    "senderCardID": "88481433-595e-4c01-941f-34569db2426e",
    "senderCardPAN": "4003********9821",
    "receiverCardID": "86496cb0-bb5d-4791-bb49-cc27a0f660ce",
    "receiverCardPAN": "5578********0613",
    "intReference": "6BD1808D0FF129B0",
    "terminalID": "95555555",
    "code": 0,
    "status": "AUTH"
}

```

__Ответ в случае неудачи:__

```
{
    "code": 487,
    "message": " Not permitted to merchant",
    "invoiceId": "8161284658525",
    "id": "",
    "reference": "",
    "accountId": "uuid000001"
}

```

После получения результата по оплате с 3DSecure необходимо переадресовать клиента на форму ввода пароля.

Для этого используются полученные параметры: paReq, md, action.

В параметре TermUrl необходимо использовать адрес, на который система мерчанта получит результат проверки 3DSecure. пароля.

Пример построения формы для перенаправления клиента:

```
<body  onload="javascript:OnLoadEvent();">
<FORM ACTION="<%=action%>" METHOD="post" NAME="ThreeDform" target="_self">
       <input name="PaReq" type="hidden" value="<%=paReq%>">
       <input name="MD" type="hidden" value="<%=md%>">
       <input name="TermUrl" type="hidden" value="https://merchantsite.com/3dRes">
</FORM>
       <div align="center"> 
                <h1>Дождитесь ответа! <br><br>
                     Жауабын күтіңіз!<br><br>
                     Wait for an answer!<br><br>                                                        
                </h1>
       </div>               
</body>
<SCRIPT>function OnLoadEvent () {
         document.forms[0].submit();
}

```
Результат проверки 3DSecure, получаемый на TermUrl мерчанта:

```
PaRes: eJzNWVnT4jiy/SsdPY9Et3ewO6gvQt53bPD+5g3vNmCDjX/9FXxV1TXVPXHnzsONIYJATqcyU0rlOZLYO+Utz/lTnt5v+cfeyMcxLvJfquzLrxY45tc/Qp0HJ6UBIXZEC3EqspDgx/nXj/3r9fhWfKv8dpgvVMRu/efRq2VFBVDlkd/Gaug/sN/R3/E98u0RermlZdxPH/s4vbKK+UGSKLWl9sjXx32X3xT+w1QcXbcEhsYIFKewPfIp3iN/9rfur9YII1+q7MM9CLyv42mIMwEpTXPmM13cLamyob/skZfGPoun/ANHcQylcPoXDP0DJf+gtnvkLd9fXuZAN9yhbYyBbtE98qNsD2fplvfp84Ng6D3y/WmfL5ehz6EGHOb39h75M7xL3H+gP3wwCmOgbSjdO8HHfqq6n8Ki/sChrbd8P07xdB8/H+vOG631x//574XXT/OPfDv8D83MUpA== MD: 270469967-9CA5EC5779A3358E 
```

Подтверждение платежа (отправка результата проверки 3DSecure пароля)

```
URL POST https://epay-api.homebank.kz/p2p/api/confirm
```

```
Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "271710719-E54F6D8F865285D4",
}
```

Response

Redirect Http code 200

Success https://epay.homebank.kz/payform/success.html Params amount currency invoiceID accountID description reference language cardid

Error https://epay.homebank.kz/payform/ invoiceID code message

Переводы по API

__Документация для API-интерфейса создания счетов в системе электронных платежей ePay:__

**Получения токена:**

**Метод: POST**

```
TEST URL POST https://testoauth.homebank.kz/epay2/oauth2/token
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token
```
Request OAuth 2.0

**Body**: form-data

```
    grant_type:        "password"
    username:          "halykfinanceUSD@halykbank.nb"
    password:          "XVp36qar"
    scope:             "api"
    client_id:         "halykfinanceUSD"
    client_secret:     "U01gQZVL##lJ$NhJ"
```

**Responce**

```json
{
    "access_token":"f2288c2b-1d08-4aac-a210-d62c0901f915",
    "token_type":"bearer",
    "refresh_token":"3f94522d-5a5a-4a22-bc85-f5f5a56920b4",
    "expires_in":43199
}
```

**URL:**
```
URL prod https://epay-api.homebank.kz/invoice
URL test https://testepay.homebank.kz/api/invoice
```

**данные для тестирования:**

```
shop_id prod: e16cfde-f3e9-49c6-8cf9-2d3f080f739c
shop_id test: 04f25a4b-d2bd-4dd8-b3a7-9390be4774c4
```

**Входные параметры:**
**Метод: JSON**

```JSON

{
    "shop_id": "2e975b11-a904-4b11-af5b-ccd834df47ef",
    "account_id": "0003413423",
    "invoice_id": "25458124232312321",
    "amount": 100,
    "language": "rus",
    "description": "asdasdasdas",
    "expire_period": "1d",
    "recipient_contact": "EXAMPLE@halykbank.kz",
    "recipient_contact_sms": "+777711111111",
    "notifier_contact_sms": "",
    "currency": "KZT",
    "post_link": "https//mail.ru",
    "failure_post_link": "https//mail.ru",
    "back_link":"https//mail.ru",
    "failure_back_link":"https//mail.ru"
}
```

**Поле**  | **Описание** |
------------- | ------------- |
**shop_id (строка)**| - ID магазина, выдается системой при регистрации магазина, обязательное|
**account_id (строка)**| - номер счета магазина в системе epay, генериурется коммерсантом, обязательное|
**invoice_id (строка)**| - уникальный идентификатор номера в системе магазина, генериурется коммерсантом, обазательное |
**amount (число)**| - сумма счета, обязательное|
**language (строка)**| - язык, на котором должна быть представлена информация о счете (допустимые значения: "rus", "kaz", "eng"), обязательное|
**description (строка)**| - описание счета, допустимое количество символов 125, обязательное|
**expire_period (строка)**| - период действия счета. Формат: "[число][единица времени]", где единица времени может принимать значение "d" (дни). Например, "2d" - счет действителен в течение двух дней, обязательное|
**recipient_contact (строка)**| - электронный адрес получателя счета, обязательное|
**recipient_contact_sms (строка)**|- номер мобильного телефона получателя счета в формате "+7XXXXXXXXXX", обязательное|
**notifier_contact_sms (строка, необязательный к заполнению)**| - номер мобильного телефона для отправки уведомлений об оплате в формате "+7XXXXXXXXXX".|
**currency (строка)**| - валюта счета (допустимые значения: "KZT"), обязательное|
**post_link (строка, необязательный)**| - URL-адрес, на который будет отправлен POST-запрос после успешной оплаты счета.|
**failure_post_link (строка, необязательный)**| - URL-адрес, на который будет отправлен POST-запрос в случае неуспешной оплаты счета.|

### Ответ:
```json
{
    "id": "afc1ce64-da89-41f7-afbf-2748ddaf3501",
    "shop_id": "4e16cfde-f3e9-49c6-8cf9-2d3f080f739c",
    "amount": 100,
    "invoice_id": "25458124232312321",
    "language": "rus",
    "currency": "KZT",
    "description": "asdasdasdas",
    "account_id": "0003413423",
    "recipient_contact": "EXAMPLE@halykbank.kz",
    "recipient_contact_sms": "+777711111111",
    "notifier_contact": "",
    "notifier_contact_sms": "+777711111111",
    "expire_period": "2d",
    "post_link": "",
    "failure_post_link": "",
    "created_date": "2023-03-28T10:04:10.997074088+06:00",
    "expire_date": "2023-03-30T10:04:10.997074088+06:00",
    "status": "ACTIVE",
    "updated_date": "0001-01-01T00:00:00Z",
    "invoice_url": "https://epay-api.homebank.kz/redirect/invoice-link/afc1ce64-da89-41f7-afbf-2748ddaf3501",
    "merchant_id": "65b0d0b8-9a95-45fc-ad58-725e45b093a0",
    "terminal_id": "0d4d345e-8566-43bd-b046-028b5aee6406"
}
```

**Поле**  | **Описание** |
------------- | ------------- |
**id (строка)**| - уникальный идентификатор счета в системе ePay.|
**shop_id (строка)**| - идентификатор магазина, зарегистрированного в системе ePay.|
**amount (число)**|- сумма счета.|
**invoice_id (строка)**| - уникальный идентификатор счета в системе магазина, от 6 до 15 цифр.|
**language (строка)**|- язык, на котором представлена информация о счете.|
**currency (строка)**| - валюта счета.|
**description (строка)**| - описание счета.|
**account_id (строка)**| - идентификатор счета магазина.|
**recipient_contact (строка)**| - электронный адрес получателя счета.|
**recipient_contact_sms (строка)**| - номер мобильного телефона|
**expire_period (строка)**| - период действия счета|
**terminal_id (GUID)**| - номер виртуального терминала в системе ePay|


ссылка на оплату по АПИ

Cсылка на оплату по API

# Apple Pay by API
**Для работы через API коммерсанту необходимо заерегестрироваться в системе apple и уметь расшифровывать данные, которые в последствии необходимо будет передавать в нашу систему**

**Интеграцию возможно проводить только в продуктовой среде**

- TerminalID – идентификатор магазина
- ClientID – идентификатор клиента
- ClientSecret – секретный ключ

## Данные для проведения тестовых платежей: 
|            |         | 
| ---------- | ---------- |
| url       | необходимо использовать продуктовые данные    |
| email       | необходимо использовать продуктовые данные    |
| password       | необходимо использовать продуктовые данные     |
| ClientID       | необходимо использовать продуктовые данные      |
| ClientSecret       | необходимо использовать продуктовые данные      |
| TerminalID       | необходимо использовать продуктовые данные      |

## Получение токена для проведения оплаты (для каждой операции необходимо получать и использовать оригинальный токен)

```
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token
```

### Запрос

```
grant_type: "client_credentials"
scope: "webapi usermanagement email_send verification statement statistics payment"
client_id: "ClientID"
client_secret: "ClientSecret"
invoiceID: "Номер заказа"
amount: 100
currency: "KZT"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"
```

### Ответ

```
{
  "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
  "expires_in": 7200,
  "scope":"webapi usermanagement email_send verification statement statistics payment",
  "token_type":"Bearer"
}
```

## Входящие параметры

| Название поля | описание | Обязательное/не обязательно |
| -------- | -------- | -------- |
| amount | сумма платежа | обязательное |
| currency| валюта |  обязательное  |
| name | имя держателя карты |  обязательное  |
| сryptogram | закриптованные параметры платежной карты |  обязательное  |
| invoiceId     | Номер заказа в магазине | обязательное  |
| invoiceIdAlt     | дополнительный номер заказа в магазине | необязательно  |
| description | В данном поле передается информация о товарах или услугах, за которые производится оплата | 
| accountId | Идентификатор клиента в системе коммерсанта или другой доп. параметр на усмотрение коммерсанта |  необязательно  |
| email  | email клиента | необязательное  |
| phone  | телефон клиента | необязательно  |
| postLink | Линк для отправки результата авторизации в магазин. |  необязательное  |
| failurePostLink | Линк для отправки неудачного результата авторизации либо информации об ошибке в магазин. |  необязательно  |
| cardSave| параметр сохранение карты, true - сохранить карту, false - не сохранять, boolean type |  обязательное  |

## Подготовка криптограммы

Структура криптограммы:
```
{
  hpan string
  expDate string
  cvc string
  terminalId string
}

пример:
{
 "hpan":"AppleToken","expDate":"expToken","cvc":"","terminalId":"67e34d63-102f-4bd1-898e-370781d0074d"
}

```

Структура должна быть зашифрованна при помощи публичного RSA-ключа, который доступен по адресу
https://epay-api.homebank.kz/public.rsa

## Проведение платежа

```
POST URL https://epay-api.homebank.kz/payment/cryptopay
```

### Запрос

Заголовок запроса:
```
Content-Type: application/json
Authorization: Bearer DCEB8O_ZM5U7SO_T_U5EJQ
```

Тело запроса:
```
{
    "amount": 10.0,
    "currency": "KZT",
    "name": "Arman Ali",
    "cryptogramApplePay": "Расшифрованная криптограмма от Apple ",
    "cryptogram": "jkasDHJIHUIHDUIOHUI23HDUI2NUIBN2I23NDJIN2OIEN2IODN0I23J0M230IDJMI023MDKDMKLSFJSDF651454564SDFIOHF984N98HFIJ2HF"
    "invoiceId": "163637162556226",
    "invoiceIdAlt":"8564546",
    "description": "Оплата через applePay",
    "accountId": "",
    "email": "armanali@gmail.com",
    "phone": "+77771232380",
    "backLink": "http://example/backLink",
    "failureBackLink": "http://example/failureBackLink",
    "postLink": "http://example/postLink",
    "failurePostLink": "http://example/failurePostLink",
    "paymentType": "applePay"
}

```

### Результат операции по оплате без 3DSecure

```
HTTP/1.1 200 OK

{
  "id":"7943816b-58a8-47f6-a11e-67b63c4228c7",
  "amount": 100,
  "currency":"KZT",
  "invoiceID":"938290483290",
  "invoiceIdAlt":"8564546",
  "accountID":"uuid000001",
  "phone":"77777777777",
  "email":"jj@example.com",
  "description":"test payment",
  "reference":"114537489258",
  "language":"rus"
}
```

### Результат по неуспешной оплате

```
HTTP/1.1 400 OK

{
    "code": 487,
    "message": " Not permitted to merchant",
    "invoiceId": "8161284658525",
    "id": "",
    "reference": "",
    "accountId": "uuid000001"
}

```

## Результат операции по оплате с 3DSecure

{
    "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "accountId": "",
    "amount": 100,
    "amountBonus": 0,
    "currency": "KZT",
    "description": "Оплата заказа 938290483290",
    "email": "",
    "invoiceID": "938290483290",
    "invoiceIdAlt":"8564546",
    "language": "RU",
    "phone": "",
    "reference": "",
    "intReference": "",
    "secure3D": {
    "paReq": "eyJtZXNzYWdlVHlwZSI2lvbiI6IjIuMS4wIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIyMDFiZDlmYy1kM2IzLTQ4YjUtYWRiNy1jYjM1YT6IjA1In0",
        "md": "MjAxYmQ5ZmsadasdtY2IzNWE1NjFhM2Mw",
        "action": "https://epay-proxy.homebank.kz/"
    },
    "cardID": "",
    "fee": 0
}

После получения результата по оплате с 3DSecure необходимо переадресовать клиента на форму ввода пароля.

Для этого используются полученные параметры: paReq, md, action.

В параметре TermUrl необходимо использовать адрес, на который система мерчанта получит результат проверки 3DSecure. пароля.

Пример построения формы для перенаправления клиента:

```
<body  onload="javascript:OnLoadEvent();">
<FORM ACTION="<%=action%>" METHOD="post" NAME="ThreeDform" target="_self">
       <input name="PaReq" type="hidden" value="<%=paReq%>">
       <input name="MD" type="hidden" value="<%=md%>">
       <input name="TermUrl" type="hidden" value="https://merchantsite.com/3dRes">
</FORM>
       <div align="center"> 
                <h1>Дождитесь ответа! <br><br>
                     Жауабын күтіңіз!<br><br>
                     Wait for an answer!<br><br>                                                        
                </h1>
       </div>               
</body>
<SCRIPT>function OnLoadEvent () {
         document.forms[0].submit();
}

```
Результат проверки 3DSecure, получаемый на TermUrl мерчанта:

```
PaRes: eJzNWVnT4jiy/SsdPY9Et3ewO6gvQt53bPD+5g3vNmCDjX/9FXxV1TXVPXHnzsONIYJATqcyU0rlOZLYO+Utz/lTnt5v+cfeyMcxLvJfquzLrxY45tc/Qp0HJ6UBIXZEC3EqspDgx/nXj/3r9fhWfKv8dpgvVMRu/efRq2VFBVDlkd/Gaug/sN/R3/E98u0RermlZdxPH/s4vbKK+UGSKLWl9sjXx32X3xT+w1QcXbcEhsYIFKewPfIp3iN/9rfur9YII1+q7MM9CLyv42mIMwEpTXPmM13cLamyob/skZfGPoun/ANHcQylcPoXDP0DJf+gtnvkLd9fXuZAN9yhbYyBbtE98qNsD2fplvfp84Ng6D3y/WmfL5ehz6EGHOb39h75M7xL3H+gP3wwCmOgbSjdO8HHfqq6n8Ki/sChrbd8P07xdB8/H+vOG631x//574XXT/OPfDv8D83MUpA== MD: MjAxYmQ5ZmsadasdtY2IzNWE1NjFhM2Mw 
```

Подтверждение платежа (отправка результата проверки 3DSecure пароля)

```
URL POST /payment/confirm
```

```
Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "MjAxYmQ5ZmsadasdtY2IzNWE1NjFhM2Mw",
}
```

Response

Redirect Http code 200

Success https://epay.homebank.kz/payform/success.html Params amount currency invoiceID accountID description reference language cardid

Error https://epay.homebank.kz/payform/ invoiceID code message

Apple Pay by API

# Google Pay by API
**Для работы через API коммерсанту необходимо заерегестрироваться в системе GOOGLE и уметь расшифровывать данные, которые, в последствии необходимо будет передавать в систему EPAY**
**Для работы по методу Pay by GOOGLE, компании необходимо наличие сертификации PCI DSS**

**Интеграцию возможно проводить только в продуктовой среде**

__ATTENTION:__

__PAN_ONLY__: __This authentication method is associated with payment cards stored on file with the user's Google Account. Returned payment data includes personal account number (PAN) with the expiration month and the expiration year__

__CRYPTOGRAM_3DS: This authentication method is associated with cards stored as Android device tokens. Returned payment data includes a 3-D Secure (3DS) cryptogram generated on the device__

- TerminalID – идентификатор магазина
- ClientID – идентификатор клиента
- ClientSecret – секретный ключ

## Данные для проведения тестовых платежей: 
|            |         | 
| ---------- | ---------- |
| url       | необходимо использовать продуктовые данные   |
| email       | необходимо использовать продуктовые данные     |
| password       | необходимо использовать продуктовые данные       |
| ClientID       | необходимо использовать продуктовые данные       |
| ClientSecret       | необходимо использовать продуктовые данные       |
| TerminalID       | необходимо использовать продуктовые данные       |

## Получение токена для проведения оплаты (для каждой операции необходимо получать и использовать оригинальный токен)

```
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token
```

### Запрос:

```
grant_type: "client_credentials"
scope: "webapi usermanagement email_send verification statement statistics payment"
client_id: "ClientID"
client_secret: "ClientSecret"
invoiceID: "Номер заказа"
amount: 100
currency: "KZT"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"
```

### Ответ:

```
{
  "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
  "expires_in": 7200,
  "scope":"webapi usermanagement email_send verification statement statistics payment",
  "token_type":"Bearer"
}
```

## Входящие параметры:

| Название поля | описание | Обязательное/не обязательно |
| -------- | -------- | -------- |
| amount | сумма платежа | обязательное |
| currency| валюта |  обязательное  |
| name | имя держателя карты |  обязательное  |
| сryptogram | закриптованные параметры платежной карты |  обязательное  |
| invoiceId     | Номер заказа в магазине | обязательное  |
| description | В данном поле передается информация о товарах или услугах, за которые производится оплата | 
| accountId | Идентификатор клиента в системе коммерсанта или другой доп. параметр на усмотрение коммерсанта |  необязательно  |
| email  | email клиента | необязательное  |
| phone  | телефон клиента | необязательно  |
| postLink | Линк для отправки результата авторизации в магазин. |  необязательное  |
| failurePostLink | Линк для отправки неудачного результата авторизации либо информации об ошибке в магазин. |  необязательно  |
| cardSave| параметр сохранение карты, true - сохранить карту, false - не сохранять, boolean type |  обязательное  |

## Подготовка криптограммы:

Структура криптограммы:
```
{
  hpan string
  expDate string
  cvc string
  terminalId string
}

пример:
{
 "hpan":"GOOGLEToken","expDate":"expToken","cvc":"","terminalId":"67e34d63-102f-4bd1-898e-370781d0074d"
}

```

Структура должна быть зашифрованна при помощи публичного RSA-ключа, который доступен по адресу
https://epay-api.homebank.kz/public.rsa

## Проведение платежа:

```
POST URL https://epay-api.homebank.kz/payment/cryptopay
```

### Запрос:

Заголовок запроса:
```
Content-Type: application/json
Authorization: Bearer DCEB8O_ZM5U7SO_T_U5EJQ
```

Тело запроса:
```js
{
    "amount": 10.0,
    "currency": "KZT",
    "name": "Arman Ali",
    "cryptogramGooglePay": "Расшифрованная криптограмм от Google",
    "сryptogram": "jkasDHJIHUIHDUIOHUI23HDUI2NUIBN2I23NDJIN2OIEN2IODN0I23J0M230IDJMI023MDKDMKLSFJSDF651454564SDFIOHF984N98HFIJ2HF"
    "invoiceId": "163637162556226",
    "invoiceIdAlt":"8564546",
    "description": "Оплата через Google",
    "accountId": "",
    "email": "ch.kabykenov@gmail.com",
    "phone": "+77778871188",
    "backLink": "http://example/backLink",
    "failureBackLink": "http://example/failureBackLink",
    "postLink": "http://example/postLink",
    "failurePostLink": "http://example/failurePostLink",
    "paymentType": "googlePay"
}

```

### Результат операции по оплате без 3DSecure

```
HTTP/1.1 200 OK

{
  "id":"7943816b-58a8-47f6-a11e-67b63c4228c7",
  "amount": 100,
  "currency":"KZT",
  "invoiceID":"938290483290",
  "invoiceIdAlt":"8564546",
  "accountID":"uuid000001",
  "phone":"77777777777",
  "email":"jj@example.com",
  "description":"test payment",
  "reference":"114537489258",
  "language":"rus"
}
```

### Результат операции по неуспешной оплате

```
HTTP/1.1 400 OK

{
    "code": 487,
    "message": " Not permitted to merchant",
    "invoiceId": "8161284658525",
    "invoiceIdAlt":"8564546",
    "id": "",
    "reference": "",
    "accountId": "uuid000001"
}

```

Status Code 

> BUYER_ACCOUNT_ERROR 
  Текущий пользователь Google не может предоставить платежную информацию.

> DEVELOPER_ERROR 
  Переданный параметр имеет неправильный формат. Сообщение об ошибке может появиться в консоли браузера для всех настроенных сред.

> MERCHANT_ACCOUNT_ERROR 
  Сайт, обращающийся к Google Pay API, не имеет необходимого разрешения. Это может быть связано как с некорректной настройкой, так и с некорректным идентификатором мерчанта, указанным в запросе. Проверьте поле statusMessage для более подробной информации. Если у вас по-прежнему возникают проблемы, обратитесь в службу поддержки.

> INTERNAL_ERROR Общая ошибка сервера.

## Результат операции по оплате с 3DSecure

```js
HTTP/1.1 200 OK

"id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "accountId": "uuid000001",
    "amount": 10,
    "amountBonus": 0,
    "currency": "KZT",
    "description": "test payment",
    "email": "jj@example.com",
    "invoiceID": "123456813",
    "invoiceIdAlt":"8564546",
    "language": "RU",
    "phone": "77777777777",
    "reference": "",
    "intReference": "",
    "secure3D": {
        "paReq": "eJxVUl1TozAU/SsMrx1JSFuXdm7jsFZ23dbKmrbO+hYhCrYEDEFrf70JC3683XPunXPuPQmcHYq98yJUnZdy5voedh0hkzLN5ePM3ayjk8A9o7DOlBBzJpJGCQpXoq75o3Dy258741Sm14EUXbV5dC26bQGVCjijqhWtTaMWcVhjLWlgL0ecr5bxtxok1q4QMLgrh4iaRaln8I44PX1cM+/DHJ5pkNvh2yVrlJjYzwaetlASArg7o3Rd03MNW37/EOlXHEpA==",
        "md": "271710719-E54F6D8F865285D4",
        "action": "https://cardsecure.kkb.kz/CommerSafeACS/pa?id=YLcP2547mFFVw"
    },
    "cardID": ""

```

После получения результата по оплате с 3DSecure необходимо переадресовать клиента на форму ввода пароля.

Для этого используются полученные параметры: paReq, md, action.

В параметре TermUrl необходимо использовать адрес, на который система мерчанта получит результат проверки 3DSecure. пароля.

Пример построения формы для перенаправления клиента:

```js
<body  onload="javascript:OnLoadEvent();">
<FORM ACTION="<%=action%>" METHOD="post" NAME="ThreeDform" target="_self">
       <input name="PaReq" type="hidden" value="<%=paReq%>">
       <input name="MD" type="hidden" value="<%=md%>">
       <input name="TermUrl" type="hidden" value="https://merchantsite.com/3dRes">
</FORM>
       <div align="center"> 
                <h1>Дождитесь ответа! <br><br>
                     Жауабын күтіңіз!<br><br>
                     Wait for an answer!<br><br>                                                        
                </h1>
       </div>               
</body>
<SCRIPT>function OnLoadEvent () {
         document.forms[0].submit();
}

```
Результат проверки 3DSecure, получаемый на TermUrl мерчанта:

```
PaRes: eJzNWVnT4jiy/SsdPY9Et3ewO6gvQt53bPD+5g3vNmCDjX/9FXxV1TXVPXHnzsONIYJATqcyU0rlOZLYO+Utz/lTnt5v+cfeyMcxLvJfquzLrxY45tc/Qp0HJ6UBIXZEC3EqspDgx/nXj/3r9fhWfKv8dpgvVMRu/efRq2VFBVDlkd/Gaug/sN/R3/E98u0RermlZdxPH/s4vbKK+UGSKLWl9sjXx32X3xT+w1QcXbcEhsYIFKewPfIp3iN/9rfur9YII1+q7MM9CLyv42mIMwEpTXPmM13cLamyob/skZfGPoun/ANHcQylcPoXDP0DJf+gtnvkLd9fXuZAN9yhbYyBbtE98qNsD2fplvfp84Ng6D3y/WmfL5ehz6EGHOb39h75M7xL3H+gP3wwCmOgbSjdO8HHfqq6n8Ki/sChrbd8P07xdB8/H+vOG631x//574XXT/OPfDv8D83MUpA== MD: 270469967-9CA5EC5779A3358E 
```

Подтверждение платежа (отправка результата проверки 3DSecure пароля)

```
URL POST /payment/confirm
```

```js
Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "271710719-E54F6D8F865285D4",
}
```

Response

Redirect Http code 200

Success https://epay.homebank.kz/payform/success.html Params amount currency invoiceID accountID description reference language cardid

Error https://epay.homebank.kz/payform/ invoiceID code message

Google Pay by API

# **__Научитесь принимать платежи при помощи Google Pay™.__** 

---

## *Инструкция по подключению*

Данная инструкция предназначена для подключения возможности оплаты через Google Pay на своей странице оплаты при взаимодействии по API. При таком способе интеграции страница оплаты должна соответствовать определенным требованиям, в том числе работать через https и отвечать требованиям Google Pay™:

---

## *Принцип работы с сервисом*

Нажав на кнопку Google Pay, пользователь переходит на страницу, где указаны способы оплаты и адреса доставки, сохраненные в его аккаунте Google. 
Здесь пользователь может быстро выбрать способ оплаты.

Как происходит процесс оплаты:

1. 	Нажав кнопку Google Pay, пользователь переходит на страницу со списком доступных способов оплаты и выбирает нужный;
2. 	Google Pay безопасно передает токен, соответствующий указанному способу оплаты, на ваш сайт;
3. 	Ваш сайт отправляет своему серверу токен и другие детали платежа;
4. 	Сервер обрабатывает данные и передает токен поставщику платежных услуг.

---

## *Платёж через API*

*__Для работы через API компании необходимо наличие сертификации PCI DSS.__*

При регистрации Вам будут выданы данные ниже, которые нужно будет использовать при проведении платежа:
•	MerchantID – идентификатор магазина
•	ClientID – идентификатор клиента
•	ClientSecret – секретный ключ

### __Получение токена для проведения оплаты__

    URL POST https://testoauth.homebank.kz/epay2/oauth2/token

### __Запрос__

    grant_type: "client_credentials"
    scope: "payment"
    client_id: "ClientID"
    client_secret: "ClientSecret"
    invoiceID: "Номер заказа"
    amount: 100
    currency: "KZT"
    terminal: "MerchantID"

### __Ответ__

    {
       "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
       "expires_in": 7200,
       "scope":"payment",
       "token_type":"Bearer"
    }

### __Дополнительно прикладываем ссылки:__
    https://testepay.homebank.kz/api/payment/cryptopay -> Test URL
    https://epay-api-staging.homebank.kz/api/payment/cryptopay – Staging URL
    https://epay-api.homebank.kz/api/payment/cryptopay -> Prod URL

### __Заголовок запроса__
    Content-Type: application/json
    Authorization: Bearer <code> DCEB8O_ZM5U7SO_T_U5EJQ </code>

### __Request JSON__

{
    "amount": 100.0,
    "currency": "KZT",
    "name": "",
    "invoiceId": "",
    "description": "",
    "accountId": "",
    "email": "",
    "phone": "",
    "backLink": "",
    "failureBackLink": "l",
    "postLink": "",
    "failurePostLink": "",
    "language": "",
    "paymentType": "googlePay",
    "googlePay": {
"apiVersionMinor": 0,
"apiVersion": 2,
"paymentMethodData": {
    "description": "Visa •••• 1111",
    "tokenizationData": {
        "type": "DIRECT",
        "token": "{\"signature\":\"MEUCIQCg8EVRDoaFCClQt/B4P85kaI0o01Te7PtzK4geb020NgIgH/4QjV0g90wiSaIp5j2khIUehyBra5EBUYW4dRi9zWw\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEiPFGsUB3r5u94GfMb/qudvqnUm1ChMQJKb9DII454LnSflKA2CmwSCofunjyme+3YFEt58fQEhMCQTrfbJNSCA\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1650607298547\\\"}\",\"signatures\":[\"MEQCICLflkEi/5Gcf+yZVeoyqSgpobNYrTbfU8RYWooXoGMPAiAdeWeuPw5PMNCJynZN+2/AzHKEujn5x8DWb6nqwD0BdA\\u003d\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"YDpsNtp8w1jnvnW1O6OBVjlX4p/cw+060kxrdHU3hOo5Dhq0UeO/2Pk6Y/lOpSq6xHgPQRM1BcalJU9QxKt6DjVm4mRx4CjZjiUu283ktfghFEmitR69HiTmvb1kRE1YAjcUpFadfoM9SsGC5YrJEe/5eRybwkn6IcSgJZZZ9CLqaw7qAjIZkZGbjNrSy9QdESDUdzcN5A7GMOWRMuQC/k9BmsBkvT7SLzikasPhLPP8z56J8E+m01nNBE5BCPhrLyu/aGoJNSdIJoRJoN88b//mS5b+TKsEIglGej8w54lpwpPr8GbqSPePHooN53QCkplY2t+LxO2Pr4jHEMb/ZaTQ36+58ZqUfV4jaYcds1SLuLMTns/3hnuTVZgg1zfBMQsNgZE5niAKPybL/RaRavRDX/GK4kVNjgsF1QWs8z2aOlBsx9krppHdthE\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BP3QeTVZ6wpe3D83/OzF5A5FoNHDDnvBffeR8PAagr5PZP55SNR237a+QPyKUYmvKPYXe1R0I61GVK09LvkeGWE\\\\u003d\\\",\\\"tag\\\":\\\"Lq8NsPTu1rdHhthYFUtzptcV7aD7ViLVD8UddD8hNzY\\\\u003d\\\"}\"}"
    },
    "type": "CARD",
    "info": {
        "cardNetwork": "VISA",
        "cardDetails": "1111"
    }
}
    }
}

---

## *Действия продавца, необходимые для подключения Google Pay к вэб-странице*

Перед тем, как принимать платежи с помощью Google Pay, ознакомьтесь со всеми требованиями и условиями со стороны Google.

Подключение веб-страницы к Googel Pay API:
•	https://developers.google.com/pay/api/web/

Документация по подключению:
•	https://developers.google.com/pay/api/web/guides/tutorial

Рекомендации для подключения веб-страницы к Google Pay:
•	https://developers.google.com/pay/api/web/guides/brand-guidelines

Документация по разбору полезной нагрузки
•	https://developers.google.com/pay/api/web/guides/resources/payment-data-cryptography?hl=ru 

Набор тестовых карт
•	https://developers.google.com/pay/api/web/guides/resources/test-card-suite?hl=ru 

---

## *Действия продавца, необходимые для подключения Google Pay к приложению*

Перед тем, как принимать платежи с помощью Google Pay, обязательно ознакомьтесь со всеми требованиями и условиями со стороны Google.

Подключение Android приложения к Google Pay API:
•	https://developers.google.com/pay/api/android/

Документация по подключению:
•	https://developers.google.com/pay/api/android/guides/tutorial

Рекомендации для подключения Android приложения к Google Pay:
•	https://developers.google.com/pay/api/android/guides/brand-guidelines

### Параметры для платёжных данных

В качестве параметров необходимо указать:

__Доступные методы платежа:__
    const allowedCardAuthMethods = ['PAN_ONLY', 'CRYPTOGRAM_3DS'];

__Тип токенизации__ - PAYMENT_GATEWAY

__Параметр gateway__
halykbank и gatewayMerchantId – можно использовать для Вашего тестирования, но для реальных платежей этот параметр должен быть получен у вашего менеджера:

     const tokenizationSpecification = {
      type: "PAYMENT_GATEWAY",
      parameters: {
  'gateway': "halykbank",
  'gatewayMerchantId': "halykbank"

### Пример настройки запросов

__1. Параметры для запуска запроса:__ 

isReadyToPay
const readyToPayRequest = {
    "apiVersion": 2,
    "apiVersionMinor": 0,
    "allowedPaymentMethods": [
{
    "type": "CARD",
    "parameters": {
        "allowedAuthMethods": [
            "PAN_ONLY",
            "CRYPTOGRAM_3DS"
        ],
        "allowedCardNetworks": [
            "MASTERCARD",
            "VISA"
        ]
    }
}
    ]
}

__2. Параметры для запуска запроса:__ 

   loadPaymentData
const paymentDataRequest = {
    "apiVersion": 2,
    "apiVersionMinor": 0,
    "allowedPaymentMethods": [
{
    "type": "CARD",
    "parameters": {
        "allowedAuthMethods": [
            "PAN_ONLY",
            "CRYPTOGRAM_3DS"
        ],
        "allowedCardNetworks": [
            "MASTERCARD",
            "VISA"
        ]
    },
    "tokenizationSpecification": {
        "type": "PAYMENT_GATEWAY",
        "parameters": {
            "gateway": "halykbank",
            "gatewayMerchantId": "halykbank"
        }
    }
}
    ],
    "transactionInfo": {
"countryCode": "RU",
"currencyCode": "RUB",
"totalPriceStatus": "FINAL",
"totalPrice": "1.00"
    }

---

## *Сценарий оплаты*

1. Клиент выбирает способ оплаты Google Pay.
2. Клиент выбирает карту или добавляет ее если нет сохраненных карт.
3. Google Pay возвращает в приложение маскированные карточные данные.
4. Приложение отображает клиенту маскированные данные карты, добавленной в Google Pay.
5. Клиент подтверждает оплату с помощью добавленной в Google Pay карты.
6. Приложение запрашивает Google Pay зашифрованные карточные данные.
7. Google шифрует данные, используя открытый ключ - соответствующий ему закрытый ключ расположен в платёжном шлюзе. Открытый ключ формируем сами и отправляем в Google (https://developers.google.com/pay/api/web/guides/resources/payment-data-cryptography?hl=ru )
8. Google возвращает в приложение зашифрованные данные о платеже.
9. Приложение отправляет в платёжный шлюз запрос на оплату Google Pay, указывая полученный от системы Google Pay токен.
10. Платёжный шлюз расшифровывает полученный токен и производит оплату. 
11. При условии, что карта вовлечена в 3-D Secure, платёжный шлюз отправляет ответ на запрос на оплату, в котором содержится ссылка перенаправления на сервер где мы вводим данные по 3D.
12. Пользователь переходит на сайт и аутентифицируется.
13. После успешной аутентификации пользователя перенаправляют с сайта ACS на старницу платёжного шлюза.
14. Платёжный шлюз возвращает результат оплаты в приложение.
15. Приложение отображает результат оплаты клиенту.

---

Все продавцы должны соблюдать Политику использования API Google Play и принимать условия, определенные в Условиях предоставления услуг API Google Pay.
https://payments.developers.google.com/terms/aup
https://payments.developers.google.com/terms/sellertos