P2P сақталған карталар бойынша аудару
Төлем жасау үшін токенді алу (әр операция үшін түпнұсқа токенді алу және пайдалану қажет)
Токенді алу үшін арналған URL
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: "webapi usermanagement email_send verification statement statistics payment" client_id: "test" client_secret: "yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG" invoiceID: "000000001" amount: 100 currency: "KZT" terminal: "67e34d63-102f-4bd1-898e-370781d0074d" postLink: "" failurePostLink: ""
| Жолы | Сипаттамасы |
|---|---|
| grant_type | Aвторизация түрі, төлем жасау үшін client_credentials түрі қолданылады |
| scope | ресурс |
| client_id | Коммерсанттың сәйкестендіргішін кабинеттен алуға болады, тіркеу кезінде беріледі |
| client_secret | Коммерсанттың кіру кілтін кабинеттен алуға болады, тіркеу кезінде беріледі |
| invoiceID | Тапсырыс нөмірін коммерсант жасайды, әрбір жаңа тапсырыс үшін тапсырыс нөмірі бірегей, 6-дан 15 цифрға дейін болуы керек. Егер сіздің тапсырыс нөміріңізде 6-дан астам таңба болса, онда бірегейлік қосымша соңғы 6 таңба бойынша сақталуы керек |
| amount | Тапсырыс сомасы |
| currency | Валюта |
| terminal | Сату орнының сәйкестендіргішін кабинеттен алуға болады, тіркеу кезінде беріледі |
| postLink | міндетті емес параметрлер, сәтті болған жағдайда postlink жіберу |
| failurePostLink | Mіндетті емес параметрлер, сәтсіз болған жағдайда postlink жіберу |
Жауап
{
"access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
"expires_in": 7200,
"refresh_token":"",
"scope":"webapi usermanagement email_send verification statement statistics payment",
"token_type":"Bearer"
}
| Жолы | Сипаттамасы |
|---|---|
| access_token | Операцияны жүргізуге арналған токен |
| expires_in | Токеннің жарамдылық мерзімі |
| refresh_token | Авторизацияның бұл түрінде қолданылмайды |
| scope | Ресурс, төлем жүргізу үшін payment ресурсы пайдаланылады |
| token_type | Авторизация түрі |
Токенді алғаннан кейін, оны Headers Bearer-ті эндпоинтқа жіберу керек
TEST URL POST https://testepay.homebank.kz/api/payments/cards/auth PROD URL POST https://epay-api.homebank.kz/payments/cards/auth
Сақталған карта бойынша аударым
Егер сіз бұрын cardsave: true параметрін берген болсаңыз, карта сақталды, төлем сәтті өтті және берілген жауапта сіз CardID алдыңыз
Аударушы картасын сақтай отырып, сақталған картаға аудару
{
"order": {
"amount": 100,
"currency": "KZT",
"description": "Test p2p payment",
"id": "8161284658529816",
"accountID": "testUser1",
"senderEmail": "dosbols@halykbank.kz",
"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": true,
"transferType": "TYPEPAN",
"cvc": "815",
"expire": {
"month": "01",
"year": "25"
},
"name": "Arman Ali",
"cardCred": "4405639704015096"
},
"receiver": {
"cardCred": "fcf69516-f7e8-9b14-e053-1d1a000aef2f",
"transferType": "TYPECARDID",
}
}
}
| Жолы | Сипаттамасы |
|---|---|
| order | Транзакция параметрлерінің жиынтығы |
| amount | Тапсырыс сомасы |
| currency | Валюта |
| description | Тапсырыс сипаттамасы |
| accountId | Дүкен клиентінің идентификаторын көрсету жолы, картаны сақтау кезінде міндетті болып табылады |
| Id | Тапсырыс нөмірі |
| Senderemail | Жіберушінің е-mail |
| terminalid | Сату нүктесінің идентификаторы (терминал идентификаторы), кабинеттен алуға болады, тіркеу кезінде беріледі |
| backLink | Төлем сәтті болған кезде дүкенге оралу сілтемесі |
| failureBackLink | Төлем сәтсіз болған кезде дүкенге оралу сілтемесі |
| Sender | Жіберуші параметрлерінің жиынтығы |
| Save | Картаны сақтау |
| TransferType | Аударым түрі, TYPEPAD бос беріледі |
| cardCred | TYPECARD кезіндегі карта нөмірі, TYPECARDID кезінде карта идентификаторы |
| CVC | Картаның CVC, typepan бос беріледі |
| Expire | Картаның жарамдылық мерзімі |
| Receiver | Алушы параметрлерінің жиынтығы |
| cardCred | Карта ПАН-ы (көрсетілген деректер түрі transfer type параметріне байланысты) |
Сәтті болған жағдайдағы жауап:
{ "id": "84d22915-f77f-491a-801c-aeb1b3b3bb36", "amount": 100, "fee": 95, "accountID": "testUser1", "currency": "KZT", "email": "dosbols@halykbank.kz", "description": "TEST p2p", "reference": "403752583641", "orderID": "8161284658529816", "senderCardID": "10606a85-ffca-b6b3-e063-1d1a000a2f3d", "senderCardPAN": "440563...5096", "senderCardType": "VISA", "senderTransferType": "TYPEPAN", "receiverCardID": "fcf69516-f7e8-9b14-e053-1d1a000aef2f", "receiverCardPAN": "440563...7622", "receiverCardType": "VISA", "receiverTransferType": "TYPECARDID", "intReference": "C2679A7844D3A007", "terminalID": "40a348cb-68a3-45d5-9002-a4836d79c3b5", "status": "CHARGE" }
| Жолы | Сипаттамасы |
|---|---|
| Id | Транзакция идентификаторы |
| amount | Аударым сомасы |
| fee | Комиссия сомасы (пайдаланылмайды) |
| accountID | Дүкен клиентінің идентификаторын көрсету жолы, картаны сақтау кезінде міндетті болып табылады |
| currency | Валюта |
| Деректерді беру кезінде көрсетілген email | |
| description | Транзакция туралы қосымша ақпарат |
| reference | Бірегей транзакция идентификаторы |
| OrderId | Бұрын берілген тапсырыс нөмірі |
| senderCardID | Жіберуші картасының идентификаторы |
| senderCardPAN | ПАН карты отправителя |
| senderTransferType | Тип проведения перевода по карте отправителя |
| receiverCardID | ID карты получателя |
| receiverCardPAN | Жіберушінің ПАН картасы |
| receiverCardType | Жіберуші картасы бойынша аударым түрі |
| receiverTransferType | Алушы картасының төлем жүйесі |
| intReference | Қосымша бірегей транзакция идентификаторы |
| terminalId | Сату нүктесінің идентификаторы (терминал идентификаторы) |
| status | Аударма мәртебесі |
Сәттіздік болған жағдайдағы жауап:
{
"code": 487,
"message": " Not permitted to merchant",
"invoiceId": "8161284658529816",
"id": "",
"reference": "",
"accountId": " testUser1"
}
| Жолы | Сипаттамасы |
|---|---|
| code | Қате коды |
| message | Қате себебін сипаттайтын хабарлама |
| invoiceId | Бұрын берілген тапсырыс нөмірі |
| id | Транзакция идентификаторы |
| reference | Бірегей транзакция идентификаторы |
| accountId | Дүкен клиентінің идентификаторын көрсету жолы |
Сақталған картадан сақталмаған картаға аудару:
{
"order": {
"amount": 100,
"currency": "KZT",
"description": "Test p2p transaction",
"accountID": "testUser1",
"id": "8161284658529823",
"senderEmail": "vyacheslavb@halykbank.kz",
"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": {
"cardCred": "10606a85-ffca-b6b3-e063-1d1a000a2f3d",
"transferType": "TYPECARDID",
"expire": null
},
"receiver": {
"save": false,
"transferType": "TYPEPAN",
"cardCred": "5522042705066736"
}
}
}
| Жолы | Сипаттамасы |
|---|---|
| order | Транзакция параметрлерінің жиынтығы |
| amount | Тапсырыс сомасы |
| currency | Валюта |
| description | Тапсырыс сипаттамасы |
| accountId | Дүкен клиентінің идентификаторын көрсету жолы, картаны сақтау кезінде міндетті болып табылады |
| Id | Тапсырыс нөмірі |
| Senderemail | Жіберушінің е-mail |
| terminalid | Сату нүктесінің идентификаторы (терминал идентификаторы), кабинеттен алуға болады, тіркеу кезінде беріледі |
| backLink | Төлем сәтті болған кезде дүкенге оралу сілтемесі |
| failureBackLink | Төлем сәтсіз болған кезде дүкенге оралу сілтемесі |
| postLink | Сәтті төлем кезінде колбек жіберілетін URL мекенжайы |
| failurePostLink | Төлем сәтсіз болған кезде колбек жіберілетін URL мекенжайы |
| Sender | Жіберуші параметрлерінің жиынтығы |
| Save | Картаны сақтау |
| TransferType | Аударым түрі, TYPEPAD бос беріледі |
| cardCred | TYPECARD кезіндегі карта нөмірі, TYPECARDID кезінде карта идентификаторы |
| CVC | Картаның CVC, typepan бос беріледі |
| Expire | Картаның жарамдылық мерзімі |
| Receiver | Алушы параметрлерінің жиынтығы |
| cardCred | Карта ПАН-ы (көрсетілген деректер түрі transfer type параметріне байланысты) |
Сәтті болған жағдайдағы жауап:
{ "id": "84d22915-f77f-491a-801c-aeb1b3b3bb36", "amount": 100, "fee": 95, "accountID": "testUser1", "currency": "KZT", "email": "dosbols@halykbank.kz", "description": "TEST p2p", "reference": "403752583641", "orderID": "8161284658529816", "senderCardID": "10606a85-ffca-b6b3-e063-1d1a000a2f3d", "senderCardPAN": "440563...5096", "senderCardType": "VISA", "senderTransferType": "TYPEPAN", "receiverCardID": "fcf69516-f7e8-9b14-e053-1d1a000aef2f", "receiverCardPAN": "440563...7622", "receiverCardType": "VISA", "receiverTransferType": "TYPECARDID", "intReference": "C2679A7844D3A007", "terminalID": "40a348cb-68a3-45d5-9002-a4836d79c3b5", "status": "CHARGE" }
| Жолы | Сипаттамасы |
|---|---|
| Id | Транзакция идентификаторы |
| amount | Аударым сомасы |
| fee | Комиссия сомасы (пайдаланылмайды) |
| accountID | Дүкен клиентінің идентификаторын көрсету жолы, картаны сақтау кезінде міндетті болып табылады |
| currency | Валюта |
| еmail | Деректерді беру кезінде көрсетілген email |
| description | Транзакция туралы қосымша ақпарат |
| reference | Бірегей транзакция идентификаторы |
| оrderId | Бұрын берілген тапсырыс нөмірі |
| senderCardID | Жіберуші картасының идентификаторы |
| senderCardPAN | ПАН карты отправителя |
| senderTransferType | Тип проведения перевода по карте отправителя |
| receiverCardID | ID карты получателя |
| receiverCardPAN | Жіберушінің ПАН картасы |
| receiverCardType | Жіберуші картасы бойынша аударым түрі |
| receiverTransferType | Алушы картасының төлем жүйесі |
| intReference | Қосымша бірегей транзакция идентификаторы |
| terminalId | Сату нүктесінің идентификаторы (терминал идентификаторы) |
| status | Аударма мәртебесі |
Қате болған жағдайда :
{
"code": 487,
"message": " Not permitted to merchant",
"invoiceId": "8161284658525",
"id": "",
"reference": "",
"accountId": "uuid000001"
}
| Жолы | Сипаттамасы |
|---|---|
| code | Қате коды |
| message | Қате себебін сипаттайтын хабарлама |
| invoiceId | Бұрын берілген тапсырыс нөмірі |
| id | Транзакция идентификаторы |
| reference | Бірегей транзакция идентификаторы |
| accountId | Дүкен клиентінің идентификаторын көрсету жолы |