P2P сақталған карталар бойынша аудару

Виртуалды терминалдың және жеке кабинеттің тестілік деректері


url	https://test-epay.homebank.kz
email	epay@halykbank.kz
password	XZG1E@Mm
ClientID	test
ClientSecret	yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG
TerminalID	67e34d63-102f-4bd1-898e-370781d0074d
__

Тестілеуге арналған карталар:

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

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

Токенді алу үшін арналған 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	Деректерді беру кезінде көрсетілген 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	Дүкен клиентінің идентификаторын көрсету жолы