Өтініш беру

Жақын арада менеджер сізге хабарласады

Қосылуға өтініш қалдырыңыз

Сіздің өтініміңіз өңдеуге қабылданды. Сізге электрондық поштаға жұмыс тәртібімен жауап беріледі.

Өтініш үшін рахмет

Сайт жасау

Tilda — бұл конструктордың бір түрі, оның көмегімен дайын блоктармен сайт жинауға болады

<a>Tilda</a> арқылы сайт жасаңыз

Толығырақ

«Қазақстан Халық банкі» АҚ филиалына келіңіз және менеджер сізге шартқа қол қоюға көмектеседі

<span>Шартқа</span> қол қойыңыз

Интернет-дүкеніңізді <span>жылдам бастаңыз</span>, бағдарламалау дағдылары жоқ

Біз сізге толық нұсқаулық дайындадық

Бейне нұсқаулық

Сайт дайын болғанда және келісімшартқа қол қойылғанда, модульді сіздің сайтыңызға қосу керек

<span>ePay</span>  модулін қосыңыз

# API
## Oauth

>> URL test https://testoauth.homebank.kz/epay2  
>> URL prod https://test-epay-oauth.epayment.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 – құпия кілт

## Төлем жасау үшін токенді алу (әр операция үшін түпнұсқа токенді алу және пайдалану қажет)
```
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,
  "secureDetails": " ", 
  "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"
    },
    "secureDetails":"F", 
    "cardID": ""

```

3D Secure арқылы төлеу бойынша нәтижені алғаннан кейін клиентті құпиясөзді енгізу нысанына бағыттау қажет.

Ол үшін мынадай алынған параметрлер қолданылады: paReq, md, action.

TermUrl параметрінде мерчант жүйесі 3D Secure құпиясөзді тексеру нәтижесін алатын мекенжайды пайдалану қажет.

Клиентті қайта бағыттау үшін нысанды құру мысалы:

```
<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();
}

```
Мерчанттың TermUrl-ға алынатын 3DSecure тексеру нәтижесі:

```
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 
```

Төлемді растау (3D Secure құпиясөзін тексеру нәтижесін жіберу)

```
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 арқылы төлем

# API бойынша P2P сервисі жұмысының сипаттамалары

__Компанияның API арқылы жұмыс істеу үшін PCI DSS сертификаты болуы керек__

Тіркеу кезінде сізге төлем жасаған кезде пайдалануыңыз қажет деректер беріледі:

|            |            |
| ---------- | ---------- |
| TerminalID       | Дүкен сәйкестендіргіші |
| ClientID       | Клиент сәйкестендіргіші |
| ClientSecret       | Құпия кілт |

### Тестілік карталар

| 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": "CHARGE"
}

```

__Сәттіздік болған жағдайдағы жауап:__

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

```

3D Secure арқылы төлеу бойынша нәтижені алғаннан кейін клиентті құпиясөзді енгізу нысанына бағыттау қажет.

Ол үшін мынадай алынған параметрлер қолданылады: paReq, md, action.

TermUrl параметрінде мерчант жүйесі 3D Secure құпиясөзді тексеру нәтижесін алатын мекенжайды пайдалану қажет. 

Клиентті қайта бағыттау үшін нысанды құру мысалы:

```
<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();
}

```
Мерчанттың TermUrl-ға алынатын 3DSecure тексеру нәтижесі:

```
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 
```

Төлемді растау (3D Secure құпиясөзін тексеру нәтижесін жіберу)

```
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 төлеміне сілтеме
ЕPay электрондық төлемдер жүйесінде шоттарды құру API-интерфейсіне арналған құжаттама:

**Токенді алу:**

**Әдісі: 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: "webapi usermanagement email_send verification statement statistics payment"
    client_id: "halykfinanceUSD"
    client_secret: "U01gQZVL##lJ$NhJ"
```

**Response**

```json
{
    "access_token": "IRPNGDU-PBYMXBCXTC5AMG",
    "expires_in": "900",
    "refresh_token": "O8EGZOGOVVAQGUAADC_WBG",
    "scope": "webapi usermanagement email_send verification statement statistics payment",
    "token_type": "Bearer"}
}
```

**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": "04f25a4b-d2bd-4dd8-b3a7-9390be4774c4",
    "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 (толтыруға міндетті емес жол)**|  Шотты сәтті төлегеннен кейін POST-сұрау салуға жіберілетін URL-мекенжайы|
**failure_post_link (толтыруға міндетті емес жол)**|  Шотты төлеу сәтсіз болған жағдайда POST-сұрау салуға жіберілетін URL-мекенжайы|

### Жауап:
```json
{
    "id": "19c435ae-fbe6-4761-863f-381f6a0fe824",
    "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://testepay.homebank.kz/api/redirect/invoice-link/19c435ae-fbe6-4761-863f-381f6a0fe824",
    "merchant_id": " ad638b1d-e515-4b9c-aab3-d3500735f6eb",
    "terminal_id": "d9d7978c-d6ee-4ec0-8cda-165251a4bf16"
}
```

**Жолы**  | **Сипаттамасы** |
------------- | ------------- |
**id (жол)**|  ePay жүйесіндегі шоттың бірегей сәйкестендіргіші |
**shop_id (жол)**| Ерay жүйесінде тіркелген дүкен сәйкестендіргіші |
**amount (сан)**| Шот сомасы |
**invoice_id (жол)**|  Дүкен жүйесіндегі шоттың бірегей сәйкестендіргіші, 6-дан 15 цифрға дейін |
**language (жол)**|Шот туралы ақпарат берілген тіл |
**currency (жол)**|  Шот валютасы |
**description (жол)**|  Шоттың сипаттамасы |
**account_id (жол)**| Дүкен шотының сәйкестендіргіші |
**recipient_contact (жол)**|  Шот алушының электрондық мекенжайы |
**recipient_contact_sms (жол)**|  Ұялы телефон нөмірі |
**expire_period (жол)**| Шоттың қолданылу кезеңі |
**terminal_id (GUID)**| 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"
```
**Жауап**

```
{
    access_token": "IRPNGDU-PBYMXBCXTC5AMG",
    "expires_in": "900",
    "refresh_token": "O8EGZOGOVVAQGUAADC_WBG",
    "scope": "webapi usermanagement email_send verification statement statistics payment",
    "token_type": "Bearer"}

}
```
**Authorization: Bearer DCEB8O_ZM5U7SO_T_U5EJQ**

**URL:**
```
TEST URL POST https://testepay.homebank.kz/api/invoice-links
PROD URL POST https://epay-api.homebank.kz/invoice-links
```
**Әдіс: POST**

**Request**

```
{
    "paging": {
        "skip": 0,
        "limit": 20
    },
    "searchParameters": [
        {
            "name": "invoice_id",
            "method": "=",
            "searchParameter": [
                "200220241201"
            ]
        }
    ],
    "orderParameters": {
        "field": "id",
        "typeOrder": "DESC"
    }
}

```

"Paging" блогына екі параметрді жіберу керек: 
- "skip" - өткізіп жіберу керек жазбалар саны; 
- "limit" - бетте көрсетілуі керек жазбалар саны.

"SearchParameters" блогына үш параметрді жіберу керек, сонымен қатар сіз көптеген өрістер бойынша іздей аласыз (сұрау мысалында көрсетілген): 
- "name" - өрістің атауы(сүзгі), ол бойынша мәліметтер базасында іздеу жүзеге асырылады, біздің жағдайда Тапсырыс нөмірі бойынша invoice_id; 
- "әдіс" - іздеу әдісі (келесі түрде көрсетіңіз: between, like,=); 
- "searchParameter" - іздеу параметрлері.Between іздеу әдісін қолданған кезде 2 параметрді, like пайдалану кезінде бір параметрді беру керек, онда % белгісі бар, in іздеу әдісінде кем дегенде 1 параметрді пайдалану керек. Дұрыс берілмеген параметрлер жағдайында қате қайтарылады. Сұрауда тапсырыс нөмірі көрсетілуі керек. Бұл іздеу параметрі міндетті болып табылады.

**Response**

```
{
    "TotalCount": 1,
    "Records": [
  {
            "id": "39400628-6ebd-4640-9a25-116fb847db37",
            "shop_id": "04f25a4b-d2bd-4dd8-b3a7-9390be4774c4",
            "amount": 400,
            "invoice_id": "200220241201",
            "language": "rus",
            "currency": "KZT",
            "description": "tes ",
            "account_id": "",
            "recipient_contact": "test@test.kz",
            "recipient_contact_sms": "+77778877887",
            "notifier_contact": "",
            "notifier_contact_sms": "+77778877887",
            "expire_period": "2d",
            "post_link": "https://epay.homebank.kz/payform",
            "failure_post_link": "https://testmerchant/order/1123/fail",
            "back_link": "",
            "failure_back_link": "",
            "created_date": "2024-02-20T15:15:29.289897+06:00",
            "expire_date": "2024-02-22T15:15:29.289897+06:00",
            "status": "CHARGED",
            "updated_date": "0001-01-01T05:07:48+05:07",
            "invoice_url": "https://testepay.homebank.kz/api/redirect/invoice-link/39400628-6ebd-4640-9a25-116fb847db37",
            "merchant_id": "ad638b1d-e515-4b9c-aab3-d3500735f6eb",
            "terminal_id": "d9d7978c-d6ee-4ec0-8cda-165251a4bf16",
            "card_save": false
        }
    ]
}

```

** Төлем сілтемесін өшіру** 

Сервис клиент оны төлей алмайтындай етіп сілтемені өшіруге мүмкіндік береді (бұл ретте, егер сілтеме бойынша төлем сәтті өтсе, ол бойынша қайтадан сәтсіздікке ұшыраса, біздің тарапта терминал нөмірі + инвойс байламы бойынша шектеу бар)
Яғни, егер сілтеме сәтті төлем жасаса, оны өшірудің қажеті жоқ. Сілтемені өшіру өткен төлемге ешқандай әсер етпейді. 

Авторизация қажет.

**Таңбалауышты алу**
**Әдіс: 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:             "webapi usermanagement email_send verification statement statistics payment"
    client_id:         "halykfinanceUSD"
    client_secret:     "U01gQZVL##lJ$NhJ"

```
**Жауап**

```
{
  "access_token": "IRPNGDU-PBYMXBCXTC5AMG",
    "expires_in": "900",
    "refresh_token": "O8EGZOGOVVAQGUAADC_WBG",
    "scope": "webapi usermanagement email_send verification statement statistics payment",
    "token_type": "Bearer"}

```
Aвторизация: Bearer DCEB8O_ZM5U7SO_T_U5EJQ

__URL : https://testepay.homebank.kz/api/deactivate/invoice-links/:invoicelinkid__

__Әдіс: PUT__

__Invoicelinkid-жасалған сілтемеге жауап беру кезінде ePay жүйесіндегі бірегей шот идентификаторы__

API арқылы төлем сілтемесі

# Картаның жарамдылығын тексеруге және қажет болған жағдайда оны сақтауға арналған қызмет 

## Төлем жасау үшін таңбалауышты алу (әр операция үшін түпнұсқа таңбалауышты алу және пайдалану қажет)

```
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: "halykfinanceUSD"
client_secret: "U01gQZVL##lJ$NhJ"
invoiceID:"Тапсырыс нөмірі"
amount: 0
currency: "USD"
terminal: "d9d7978c-d6ee-4ec0-8cda-165251a4bf16"

```

### Жауап

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

## Кіріс параметрлері

| Атауы | Сипаттама | міндетті/міндетті емес |
| -------- | -------- | -------- |
| amount | төлем сомасы әрқашан 0 | міндетті |
| currency | валюта әрқашан USD | міндетті |
| name | карта ұстаушының аты | міндетті |
| сryptogram | төлем картасының криптографиялық параметрлері | міндетті |
| invoiceid | Коммерсант жасаған Тапсырыс нөмірі болуы керек бірегей әрбір жаңа тапсырыс үшін 6-дан 15 санға дейін. __егер сіздің тапсырыс нөміріңізде 6-дан астам таңба болса, онда қосымша бірегейлік соңғы 6 таңбаға сәйкес сақталуы керек__ | міндетті |
| invoiceidalt | Коммерсант жасаған Тапсырыс нөмірі болуы керек бірегей әрбір жаңа тапсырыс үшін 6-дан 15 санға дейін | міндетті емес |
| description | осы өрісте төлем жүргізілетін тауарлар немесе қызметтер туралы ақпарат беріледі | міндетті|
| accountId | саудагер жүйесіндегі клиент идентификаторы немесе басқа қосымша опция саудагердің қалауы бойынша | міндетті емес |
| email | клиенттің электрондық поштасы | қосымша |
| телефон | тұтынушы телефоны | қосымша |
| postlink | авторизация нәтижесін дүкенге жіберу үшін сілтеме | міндетті |
| failurepostlink | сәтсіз авторизация нәтижесін немесе қате туралы ақпаратты дүкенге жіберу үшін сілтеме | міндетті емес |
| cardsave | картаны сақтау параметрі, true-картаны сақтау, false-сақтамау | boolean type | міндетті |
| деректер | қосымша өріс толтырылған кезде есепте таратылады | міндетті емес |

## Криптограмманы дайындау

Криптограмма құрылымы:
```
{
  hpan string
  expDate string
  cvc string
  terminalId string
}
```
Мысал:
```
{
 "hpan":"4003032704547597",
 "expDate":"1022",
 "cvc":"636",
 "terminalId":"0d4d345e-8566-43bd-b046-028b5aee6406"
}

```

Құрылым Жалпыға қол жетімді 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":0,
  "currency":"USD",
  "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,
  "paymentType": "cardVerification",
  "data": "{\"statement\":{\"name\":\"Arman     Ali\",\"invoiceID\":\"80000016\"}}",
  "postLink":"https://testmerchant/order/1123",
  "failurePostLink":"https://testmerchant/order/1123/fail"
}

```

## 3D Secure жоқ сәтті төлем операциясының нәтижесі

```
HTTP/1.1 200 OK

{
  "id":"7943816b-58a8-47f6-a11e-67b63c4228c7",
  "accountID": "uuid000001",
  "amount": 0,
  "amountBonus": 0,
  "currency": "USD",
  "description": "test payment",
  "email": "jj@example.com",
  "invoiceID": "938290483290",
  "language": "RUS"
  "phone":"77777777777",
  "reference": "114537489258",
  "intReference": "435G34G34534T546",
  "secure3D": null,
  "cardID": "111DFSDF-3F43-18V4-V34-ASD12342323",
  "fee": 0,
  "code": 0,
  "status":"VERIFIED",
  "secureDetails": ""
  "qrReference": ""
}

```

## Төлем бойынша сәтсіз операцияның нәтижесі 
```

HTTP/1.1 400 OK

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

```

## 3D Secure төлем операциясының нәтижесі

```
HTTP/1.1 200 OK

"id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "accountId": "uuid000001",
    "amount": 0,
    "amountBonus": 0,
    "currency": "USD",
    "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": ""

```

3D Secure төлем нәтижесін алғаннан кейін клиентті пароль енгізу формасына бағыттау қажет.

Ол үшін алынған параметрлер қолданылады: paReq, md, action.

Term Url параметрінде саудагер жүйесі 3D Secure тексеру нәтижесін алатын мекенжайды пайдалану қажет. құпия сөз.

Клиентті қайта бағыттау үшін форманы құру мысалы:

```
<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();
}

```
Саудагердің TermUrl сайтында алынған 3DSecure тексеру нәтижесі:

```
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 
```
Төлемді растау (3D Secure паролін тексеру нәтижесін жіберу)

```
URL POST https://epay-api.homebank.kz/payments/confirm?Access=:token
```

```
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",
}
```

## Сәтті операцияның нәтижесі

```

HTTP/1.1 200 OK

{
  "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
  "accountID": "uuid000001",
  "amount": 0,
  "amountBonus": 0,
  "currency": "USD",
  "description": "test payment",
  "email": "jj@example.com",
  "invoiceID": "938290483290",
  "language": "RUS"
  "phone": "77777777777",
  "reference": "114537489258",
  "intReference": "435G34G34534T546",
  "secure3D": yes,
  "cardID": "111DFSDF-3F43-18V4-V34-ASD12342323",
  "fee":0,
  "code":0,
  "status":"VERIFIED",
  "secureDetails": "",
  "qrReference": ""
}

```

Проверка/сохранение карты

# Apple Pay by API
**API арқылы жұмыс істеу үшін коммерсант apple жүйесіне тіркеліп, кейінірек біздің жүйеге жіберілуі керек деректерді толық аша білуі керек**

**Интеграция тек өнім ортасында жүзеге асырылуы мүмкін**

- TerminalID – дүкен сәйкестендіргіші
- ClientID – клиент сәйкестендіргіші
- ClientSecret – құпия кілт

## Төлем жасау үшін токенді алу (әр операция үшін түпнұсқа токенді алу және пайдалану қажет)

```
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"
}
```

## Кіру параметрлері

| Жол атауы | Cипаттамасы | Міндетті/міндетті емес |
| -------- | -------- | -------- |
| amount | Tөлем сомасы | Mіндетті |
| currency| Bалюта |  Mіндетті  |
| name | Kарта ұстаушының аты | Mіндетті  |
| сryptogram | Tөлем картасының скриптелген параметрлері |  Mіндетті  |
| invoiceId     | Дүкендегі тапсырыс нөмірі | Mіндетті  |
| invoiceIdAlt     | Дүкендегі қосымша тапсырыс нөмірі | Mіндетті емес  |
| description | Бұл жолда төлем жүргізілетін тауарлар немесе қызметтер туралы ақпарат беріледі | 
| accountId | Коммерсант жүйесіндегі клиент сәйкестендіргіші немесе коммерсанттың қалауы бойынша басқа қосымша параметр|  Mіндетті емес  |
| email  | Kлиенттің email-ы | Mіндетті емес  |
| phone  | Kлиент телефоны | Mіндетті емес  |
| postLink | Авторизация нәтижесін дүкенге жіберуге арналған сілтеме |Mіндетті емес |
| failurePostLink | Сәтсіз авторизация нәтижесін немесе қате туралы ақпаратты дүкенге жіберуге арналған сілтеме |  Mіндетті емес  |
| cardSave| Kартаны сақтау параметрі, true - картаны сақтау, false-сақтамау, boolean type |  Mіндетті |

## Криптограмманы дайындау

Криптограмма құрылымы:
```
{
  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
```

Сұрау салу деректері:
``` json 
{
    "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-сіз төлеу бойынша жасалған операцияның нәтижесі

``` json
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"
}
```

### Сәтсіз төлеу бойынша нәтиже

```json
HTTP/1.1 400 OK

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

```

## 3DSecure арқылы төлеу бойынша жасалған операцияның нәтижесі
```JSON
{

    "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

}
```
3D Secure арқылы төлеу бойынша нәтижені алғаннан кейін клиентті құпиясөзді енгізу нысанына бағыттау қажет.

Ол үшін мынадай алынған параметрлер қолданылады: paReq, md, action.
TermUrl параметрінде мерчант жүйесі 3D Secure құпиясөзді тексеру нәтижесін алатын мекенжайды пайдалану қажет. 

Клиентті қайта бағыттау үшін нысанды құру мысалы:

``` json
<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();
}

```
Мерчанттың TermUrl-ға алынатын 3DSecure тексеру нәтижесі:

```
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 
```

Төлемді растау (3D Secure құпиясөзін тексеру нәтижесін жіберу)

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

``` json
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 API арқылы

# Шифрланған деректермен Google Pay арқылы төлем сұрауын жіберуге арналған құжаттама (PAYMENT_GATEWAY):

## Төлем жүргізу үшін токен алу (әрбір операция үшін түпнұсқа токен алу және пайдалану қажет)
```
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: "Order number"
amount: 100
currency: "KZT"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"
``

### Жауап:
``` JSON
{
"access_token": "DCEB8O_ZM5U7SO_T_U5EJQ",
"expires_in": 7200,
"scope": "webapi usermanagement email_send verification statement statistics payment",
"token_type": "Bearer"
}
```

## Кіріс параметрлері:
| Жол атауы | Cипаттама | Міндетті/міндетті емес |
| -------- | -------- | -------- |
| amount | Tөлем сомасы | Mіндетті |
| currency| Bалюта | Mіндетті |
| name | Kарта ұстаушының аты  | Mіндетті |
| cryptogram | Төлем картасының криптограммаланған параметрлері | Mіндетті |
| invoiceID | Тапсырыс нөмірін коммерсант береді, ол әрбір жаңа тапсырыс үшін бірегей болуы тиіс, 6 саннан 15 санға дейін. Егер сіздің тапсырыс нөміріңіздің саны 6 таңбадан асатын болса, онда бірегейлік соңғы 6 таңба бойынша қосымша сақталуы тиіс  | Mіндетті |
| invoiceIdAlt | Тапсырыс нөмірін коммерсант береді, ол әрбір жаңа тапсырыс үшін бірегей болуы тиіс, 6 саннан 15 санға дейін| Mіндетті емес |
| description | Бұл жолда төлем жасалатын тауарлар немесе қызметтер туралы ақпарат беріледі | Mіндетті |
| accountId | Коммерсант жүйесіндегі клиенттің идентификаторы немесе коммерсанттың қарауы бойынша басқа қосымша параметр | Mіндетті емес |
| email | Kлиенттің email | Mіндетті емес |
| phone | Kлиенттің телефоны |Mіндетті емес |
| postLink |  Авторизация нәтижесін дүкенге жіберуге арналған линк | Mіндетті |
| failurePostLink | Сәтсіз авторизация нәтижесін немесе қате туралы ақпаратты дүкенге жіберуге арналған линк. | Mіндетті емес |
| cardSave| Kартаны сақтау параметрі, true – картаны сақтау, false - сақтамау, boolean type | Mіндетті |
| data| Қосымша жол толтырылған кезде есепте таратылады  | Mіндетті емес |

# Төлем жүргізу
## URL: https://epay-api.homebank.kz/payment/cryptopay
## Әдіс: POST
## Сұрау салу денесі:

``` json
{
    "amount": 10,
    "currency": "KZT",
    "name": "Test test",
    "terminalId": "b861ab50-8387-46c3-be6e-f439d4492c3c",
    "invoiceId": "80000148",
    "description": "Оплата",
    "accountId": "",
    "email": "nemesis_311@gmail.com",
    "phone": "+77078071180",
    "backLink": "http://example/backLink",
    "failureBackLink": "http://example/failureBackLink",
    "postLink": "http://example/postLink",
    "failurePostLink": "http://example/failurePostLink",
    "cardSave": false,
    "useBonus": false,
    "paymentType": "googlePay",
    "googlePay": {
        "apiVersionMinor": 0,
        "apiVersion": 2,
        "paymentMethodData": {
            "description": "Visa •••• 1111",
            "tokenizationData": {
                "type": "PAYMENT_GATEWAY",
               "token": "{\"signature\":\"MEQCIG0Pt0VSb8/W00fzbPLtO5z3DYNrG1IrU94YI0U3VZw3AiAekJRW2Bcq1+hPbcbBniw9vRNSH2w3+qFX5EcQwkJo1w\\u003d\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwIIrniC3/DfJjejVaHVsBGZLO9LW9ggLXWaoEVnpZuFgLSH4qEanNlHvZkr6A04aVq/7HgYaxLkotk6ZKSr3qQ\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1695271732552\\\"}\",\"signatures\":[\"MEQCIFurLZqmGGY9jZ+ZL+8iHtdxFRY3VMdKwcxrO0tunvuoAiBywEKS7Q2qwh4SmjY99tNaVYrfr8/Cygd8c/0XoP2K4Q\\u003d\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"5XrIV3etzcSBdH8fgO+eCIxH3jWrGSUPPVXci3s22nD5Ab+9EtihPz/Zc3ODVwINNWOtkqfJxiu3UUaz1LbICfM1I2rhqyANCc35fK+Fd/JZNQv7eFNVVNxVdt2eBiQxPod+2K5v4jCJJkGevdbqQUW1OncL1QXpt8e/dNj1o7CTGCxxV6iN+8DjAo4xyvZJqKsjA3PzzKDhfNdM6zohKcgNqtPP30uI8EGK1PdGQDFCuPYFRYpKCVOx3qibRuI5x46pHV86GLUmMDbETSNOIYnwpOu0RVcMLdb74xQ9awoiXILSSM/IGhQUJnxeUbckzYsqwbZ88Ks6kmbHmCs3oHcgL4Lblt7hE07vW1Y1VJQ05/oTcT98R9WWzKeOTSvA8ru7o3oUxdwww1QIb9VytOz2IbGiI+ZepGehImTxsOUJkG3QwoFevDVDV67cf6KfTxUd97OarcE6Nk3crwO+GIASJw/U5lycj74HRd/h25Fme8TFf6BMmcOHUezy6Tx+iHO5j3P0QMDT0a4bVb8wuUPa0CE1DQH75E+EVSUb2tmRURkqDrDKCN6GP2VCvxqsSzV26zZbl8Xv\\\",\\\"ephemeralPublicKey\\\":\\\"BOmDg7vgShCeyoYT5EgzyV8NGdh3AbDe1yHmf2WRv+tKYlfjd8bhGJnc1hkLVjY80VKFBxUw2eDhqd1bGzXoxQ0\\\\u003d\\\",\\\"tag\\\":\\\"I9P/hCUvJTg+cVO7H+snaOAtACB9J0gySh/LEih0yH8\\\\u003d\\\"}\"}"
               },
            "type": "CARD",
            "info": {
                "cardNetwork": "VISA",
                "cardDetails": "1111"
            }
        }
    }
}

```
 ## Сұрау салу жолы:

| amount | Currency жолында көрсетілген валютамен төлем сомасы |
| -------- | -------- |
| currency | ISO 4217 форматындағы төлем валютасы (мысалы, қазақстандық теңге үшін «KZT») |
| name | Төлеушінің аты |
| terminalId | Төлемді өңдеуге арналған терминал немесе дүкен идентификаторы |
| invoiceId | Төлемге байланысты шот немесе тапсырыс идентификаторы |
| description | Төлемнің сипаттамасы |
| accountId | Төлеуші аккаунтының идентификаторы (егер қолданылса) |
| email | Төлеушінің электрондық поштасының мекенжайы. |
| phone |  Төлеушінің телефон нөмірі |
| backLink | Төлем сәтті аяқталғаннан кейін пайдаланушыны қайта бағыттауға арналған URL |
| FailureBacklink | Төлем сәтсіз аяқталған жағдайда пайдаланушыны қайта бағыттауға арналған URL |
| postlink | Төлем провайдері сәтті аяқталғаннан кейін төлем мәртебесі туралы кері байланыс жіберетін URL |
| failurePostlink |  Төлем провайдері сәтсіз аяқталған жағдайда төлем мәртебесі туралы кері байланыс жіберетін URL |
| cardSave |  Болашақ төлемдер үшін төлеуші картасының деректерін сақтау қажет пе, жоқ па, соны көрсететін жалауша (бұл жағдайда false мәні орнатылған) |
| useBonus | Төлем жасау үшін төлеушінің бонустық қаражатын пайдалану керек пе, жоқ па, соны көрсететін жалауша (бұл жағдайда false мәні орнатылған). |
| paymentType | Төлем түрі, бұл жағдайда googlePay мәні орнатылған  |
| googlePay | Google Pay пайдалану арқылы төлем туралы ақпаратты қамтитын объект |
| apiVersionMinor | API Google Pay нұсқасы (бұл жағдайда 0 мәні орнатылған) |
| apiVersion | API Google Pay нұсқасы (бұл жағдайда 2 мәні орнатылған)|
| paymentMethodData | Пайдаланылатын төлем тәсілі туралы ақпаратты қамтитын объект|
| descrption | Төлем тәсілінің сипаттамасы (мысалы, «Visa •••• 1111») |
| tokenizationData | Төлем деректерінің токенделуі туралы ақпаратты қамтитын объект|
| type | Токендеу түрі (бұл жағдайда PAYMENT_GATEWAY мәні орнатылған)|
| token | Google жүйесінен алынған токен мәні |
| type | Төлем тәсілінің түрі (бұл жағдайда CARD мәні белгіленген)|
| info | Төлем картасы туралы ақпаратты қамтитын объект |
| cardNetwork | Төлем картасының желісі (мысалы, «VISA») |
| cardDetails | Төлем картасы нөмірінің соңғы төрт саны (мысалы, «1111») |

API төлемге сұрауды жібергеннен кейін, сіз төлем мәртебесі туралы ақпаратпен жауаптың алынуын күтесіз. Төлем мәрбтебесін тексеру сервисін пайдаланып жүйеде жауапты сәйкесінше өңдеңіз.

```
TEST URL: GET https://testepay.homebank.kz/api/check-status/payment/transaction/:invoiceid
```
```
PROD URL: GET https://epay-api.homebank.kz/check-status/payment/transaction/:invoiceid
```

## Авторизация қажет:
Сұрау салу
Токен алу

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

```
## Body: form-data
``` json
grant_type: "client_credentials"
scope: "webapi usermanagement email_send verification statement statistics payment"
client_id: "test"
client_secret: "yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"

```
| Жол | Сипаттама | 
| -------- | -------- | 
| grant type | Aвторизация түрі, төлем жүргізу үшін client_credentials түрі пайдаланылады | 
| scope| Pесурс | 
| client id | Коммерсанттың идентификаторы, кабинетте алуға болады, тіркеу кезінде беріледі |
| client secret | Коммерсанттың кіру кілті, кабинетте алуға болады, тіркеу кезінде беріледі |
| terminal id | Сату нүктесінің идентификаторы, кабинетте алуға болады, тіркеу кезінде беріледі | 

### Жауап:
``` json
{
"access_token": "DCEB8O_ZM5U7SO_T_U5EJQ",
"expires_in": 7200,
"scope": "webapi usermanagement email_send verification statement statistics payment",
"token_type": "Bearer"
}
```

| Жол | Сипаттама | 
| -------- | -------- | 
| access token | Операция жүргізуге арналған токен | 
| expires in| Токеннің аяқталу уақыты | 
| refresh token | Авторизацияның бұл түрінде пайдаланылмайды |
| scope | Ресурс, төлем жүргізу үшін ресурс пайдаланылады |
| token type | Авторизация түрі | 

``` json
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=

HTTP CODE 200

Responce Body JSON:

{
    "resultCode": "100",
    "resultMessage": "SUCCESS",
    "transaction": {
        "id": "af2089fe-43b1-47eb-a61f-c78dd196e18d",
        "createdDate": "2022-11-15T03:52:17.289853+06:00",
        "invoiceID": "205218074",
        "amount": 12.22,
        "amountBonus": 0,
        "payoutAmount": 10,
        "orgAmount": 22.22,
        "approvalCode": "170243",
        "data": "{\"custom_id\":\"2023.03.10-15:03:58\",\"email\":\"epay@halykbank.kz\",\"deal_number\":\"1111111\",\"offer_code\":\"1111111\",\"sum\":33900}",
        "currency": "KZT",
        "terminal": "98120001",
        "terminalID":"67e34d63-102f-4bd1-898e-370781d0074d",
        "accountID": "",
        "description": "order 205218074",
        "language": "RU",
        "cardMask": "400303...9821",
        "cardType": "VISA",
        "issuer": "Казкоммерцбанк",
        "reference": "231951411351",
        "reason": "Successfully",
        "reasonCode": "00",
        "intReference": "67140D7DE97139A7",
        "secure": false,
        "statusID": "5bbb7dd5-4691-41ee-a6a5-755a3d23a218",
        "statusName": "REFUND",
        "name": "ARMAN ALI",
        "email": "epay@halykbank.kz",
        "phone": "",
        "cardID": "e8a09f98-04b4-71a6-e053-1d1a000aa0d2",
        "xlsRRN": "",
        "ip": "46.148.239.182",
        "ipCountry": "Kazakhstan",
        "ipCity": "",
        "ipRegion": "",
        "ipDistrict": "",
        "ipLatitude": 55.7386,
        "ipLongitude": 37.6068
    }
}
```

### Error:
``` json
{
    "resultCode": "101",
    "resultMessage": "reject",
    "transaction": null
}
```

 ## resultcode
| Жол | Сипаттама |  |
| -------- | -------- | -------- |
| 100 | Success | Cұраудың сәтті орындалуы, төлемнің қандай күйде екенін statusName бойынша көру қажет |
| 101 | Reject | Cәтсіз транзакция |
| 102 | Invoice not found, try again later or check transaction type (payment/p2p) |  InvoiceId нөмірі жүйеде табылмады, сіздің транзакцияңыз p2p сервисі бойынша өтуі мүмкін|
| 103 | Try again or contact support |Cұрауды қайталау немесе қолдау қызметіне жүгіну қажет  |
| 104 | Field terminal absent in token | Токенді сұраған кезде TerminalID параметрі жоқ |
| 106 | Error, incorrect terminalID | Токенді сұраған кездегі қате TerminalID |
| 107 | In progress | Oперация орындалу процесінде, мәртебені кейінірек сұратыңыз |

## status name
| Жол | Сипаттама |  
| -------- | -------- | 
| REFUND | Eсептен шығарылған соманы қайтару жүзеге асырылды | 
| AUTH | Бұғатталған сома | 
| CANCEL | Сома блоктан алынды |
| CHARGE | Сома есептен шығарылды |
| CANCEL_OLD | Эмитент жағында авторизацияның күшін жою CHARGE/CANCEL операциясының қолданыс мерзімі аяқталған жағдайда орын алады |
| FAILED | Сәтсіз транзакция |
| 3D | 3D тексеру кезеңіндегі қателік | 
| NEW | Операция құрылды, бірақ әзірге ол аралық күйде (егер сіз осы мәртебені транзакция мәртебесін сұрауды қолмен жүзеге асырған кезде алсаңыз, онда оны өзгертуге болатындығын ескеріңіз) |
| REJECT | Сәтсіз төлем әрекеті | 

### Жүйені қайтаратын ықтимал reasonCode https://epayment.kz/kk/docs/kody-oshibok ресурсында орналасқан 


Google Pay арқылы төлем сұрауын жіберуге арналған құжаттама

# Google Pay by API
**API арқылы жұмыс істеу үшін коммерсант GOOGLE жүйесіне тіркеліп, кейінірек EPAY жүйесіне жіберілуі керек деректерді толық аша білуі керек**
**Pay by GOOGLE әдісі бойынша жұмыс істеу үшін компанияның PCI DSS сертификатының болуы қажет**

**Интеграция тек өнім ортасында жүзеге асырылуы мүмкін**

__НАЗАР АУДАРЫҢЫЗ:__

__PAN_ONLY__: __Бұл аутентификация әдісі пайдаланушының Google Есептік жазбасында файлда сақталған төлем карталарымен байланысты. Қайтарылған төлем деректеріне жарамдылық мерзімі мен жарамдылық мерзімі көрсетілген жеке шот нөмірі (PAN) кіреді__

__CRYPTOGRAM_3DS: Бұл аутентификация әдісі Android құрылғысының таңбалауыштары ретінде сақталған карталармен байланысты. Қайтарылған төлем деректері құрылғыда жасалған 3-D Secure (3DS) криптограммасын қамтиды__

- TerminalID – дүкен сәйкестендіргіші
- ClientID – клиент сәйкестендіргіші
- ClientSecret – құпия кілт

## Тестілік төлемдерді жүргізуге арналған деректер: 
|            |         | 
| ---------- | ---------- |
| url       | Өнім деректерін пайдалану қажет  |
| email       | Өнім деректерін пайдалану қажет     |
| password       | Өнім деректерін пайдалану қажет       |
| ClientID       | Өнім деректерін пайдалану қажет      |
| ClientSecret       | Өнім деректерін пайдалану қажет      |
| TerminalID       | Өнім деректерін пайдалану қажет       |

## Төлем жасау үшін токенді алу (әр операция үшін түпнұсқа токенді алу және пайдалану қажет)

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

### Сұрау салу:

```JSON
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"
```

### Жауап:

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

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

| Жол атауы | Cипаттамасы | Міндетті/міндетті емес |
| -------- | -------- | -------- |
| amount |Tөлем сомасы | Mіндетті |
| currency| Bалюта |  Mіндетті  |
| name | Kарта ұстаушының аты |  Mіндетті  |
| сryptogram | Tөлем картасының скриптелген параметрлері |  Mіндетті  |
| invoiceId     | Дүкендегі тапсырыс нөмірі | міндетті  |
| description | Бұл жолда төлем жүргізілетін тауарлар немесе қызметтер туралы ақпарат беріледі | 
| accountId | Коммерсант жүйесіндегі клиент сәйкестендіргіші немесе коммерсанттың қалауы бойынша басқа қосымша параметр|  Mіндетті емес  |
| email  | Kлиенттің email-ы | Mіндетті емес  |
| phone  | Kлиент телефоны | Mіндетті емес  |
| postLink | Авторизация нәтижесін дүкенге жіберуге арналған сілтеме | Mіндетті емес |
| failurePostLink | Сәтсіз авторизация нәтижесін немесе қате туралы ақпаратты дүкенге жіберуге арналған сілтеме |  Mіндетті емес  |
| cardSave| Kартаны сақтау параметрі, true - картаны сақтау, false-сақтамау, boolean type |  Mіндетті |

## Криптограмманы дайындау:

Криптограмма құрылымы:
``` JSON 
{
  hpan string
  expDate string
  cvc string
  terminalId string
}
```
Mысал:
```
{
 "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"
}
```

### Сәтсіз төлеу бойынша жасалған операцияның нәтижесі

```JSON
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": ""

```

3D Secure арқылы төлеу бойынша нәтижені алғаннан кейін клиентті құпиясөзді енгізу нысанына бағыттау қажет.

Ол үшін мынадай алынған параметрлер қолданылады: paReq, md, action.

TermUrl параметрінде мерчант жүйесі 3D Secure құпиясөзді тексеру нәтижесін алатын мекенжайды пайдалану қажет. 

Клиентті қайта бағыттау үшін нысанды құру мысалы:

```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();
}

```
Мерчанттың TermUrl-ға алынатын 3DSecure тексеру нәтижесі:
```
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 
```

Төлемді растау (3D Secure құпиясөзін тексеру нәтижесін жіберу)

```
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

API бойынша Google Play

# **__Google Pay™ көмегімен төлемдерді қабылдауды үйреніңіз.__** 

---

## *Қосылу бойынша нұсқаулық*

Бұл нұсқаулық API арқылы өзара әрекеттесу кезінде өз төлем бетінде Google Pay арқылы төлеу мүмкіндігін қосуға арналған. Интеграцияның осындай әдісі болған кезде төлем беті белгілі бір талаптарға сай болуы керек, оның ішінде https арқылы жұмыс істей білуі және Google Pay ™ талаптарына сай болуы керек:

---

## *Сервиспен жұмыс істеу принципі*

Google Pay батырмасын басу арқылы пайдаланушы Google аккаунтында сақталған төлеу әдістері мен жеткізу мекенжайлары көрсетілген бетке өтеді. Мұнда пайдаланушы төлеу әдісін тез таңдай алады.

Төлеу процесі қалай жүреді:

1.	Google Pay батырмасын басу арқылы пайдаланушы қол жетімді төлеу әдістерінің тізімі бар бетке өтіп, қалағанын таңдайды;
2.	Google Pay көрсетілген төлеу әдісіне сәйкес келетін токенді сіздің сайтыңызға қауіпсіз түрде жібереді;
3.	Сіздің сайтыңыз серверіңізге токенді және төлемнің басқа да егжей-тегжейлерін жібереді;
4.	Сервер деректерді өңдейді және токенді төлем қызметтерін жеткізушіге береді.

---

## *API арқылы төлеу*

*__API арқылы жұмыс істеу үшін компанияның PCI DSS сертификаты болуы керек.__*

Тіркелу кезінде Сізге төлем жасау кезінде пайдалану қажет төмендегі деректер беріледі:

- TerminalID – дүкен сәйкестендіргіші
- ClientID – клиент сәйкестендіргіші
- ClientSecret – құпия кілт

### Төлем жасау үшін токенді алу
``` JSON
    URL POST https://testoauth.homebank.kz/epay2/oauth2/token
```

### Cұрау салу
```JSON
    grant_type: "client_credentials"
    scope: "payment"
    client_id: "ClientID"
    client_secret: "ClientSecret"
    invoiceID: "Номер заказа"
    amount: 100
    currency: "KZT"
    terminal: "MerchantID"
```
### Жауап
```JSON 
    {
       "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

### Сұрау салу тақырыбы
```JSON
    Content-Type: application/json
    Authorization: Bearer <code> DCEB8O_ZM5U7SO_T_U5EJQ </code>
```
### Request JSON
```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__
Gateway halykbank және gatewayMerchantId параметрлері - тестілеуіңіз үшін қолдануға болады, бірақ нақты төлемдер үшін бұл параметрді менеджеріңізден алуыңыз керек:
``` JSON
     const tokenizationSpecification = {
      type: "PAYMENT_GATEWAY",
      parameters: {
  'gateway': "halykbank",
  'gatewayMerchantId': "halykbank"
```
### Сұрау салуларды баптау мысалы

__1.Сұрау салуларды іске қосуға арналған параметрлер:__ 
```JSON
isReadyToPay
const readyToPayRequest = {
    "apiVersion": 2,
    "apiVersionMinor": 0,
    "allowedPaymentMethods": [
{
    "type": "CARD",
    "parameters": {
        "allowedAuthMethods": [
            "PAN_ONLY",
            "CRYPTOGRAM_3DS"
        ],
        "allowedCardNetworks": [
            "MASTERCARD",
            "VISA"
        ]
    }
}
    ]
}
```
__2.Сұрау салуларды іске қосуға арналған параметрлер:__ 
```JSON
   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.	Қосымша клиентке төлем нәтижесін көрсетеді.

---

Барлық сатушылар Google Play API пайдалану саясатын ұстанып, Google Pay API қызметтерін ұсыну талаптарында белгіленген талаптарды қабылдауы керек. https://payments.developers.google.com/terms/aup https://payments.developers.google.com/terms/sellertos