Төлем картасын сақтау

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


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

Test merchant


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

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

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: 		0
currency: 		"USD"
terminal: 		"67e34d63-102f-4bd1-898e-370781d0074d"
postLink:       ""
failurePostLink: ""

Жолы	Сипаттама
grant_type	Авторизация түрі, төлем жасау үшін client_credentials түрі қолданылады
scope	Ресурс
client_id	Коммерсанттың сәйкестендіргішін кабинеттен алуға болады, тіркеу кезінде беріледі
client_secret	Коммерсанттың кіру кілтін кабинеттен алуға болады, тіркеу кезінде беріледі
invoiceID	Тапсырыс нөмірін коммерсант жасайды, әрбір жаңа тапсырыс үшін тапсырыс нөмірі бірегей, 6-дан 15 цифрға дейін болуы керек. Егер сіздің тапсырыс нөміріңізде 6-дан астам таңба болса, онда бірегейлік қосымша соңғы 6 таңба бойынша сақталуы керек
amount	Тапсырыс сомасы
currency	Валюта
terminal	Сату орнының сәйкестендіргішін кабинеттен алуға болады, тіркеу кезінде беріледі
postLink	Міндетті параметрлер, сәтті болған жағдайда postlink жіберу
failurePostLink	Міндетті емес параметрлер, сәтсіз болған жағдайда 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	Ресурс, төлем жүргізу үшін ресурс пайдаланылады
token_type	Авторизация түрі

Төлем жасау

Бетте JS-кітапханасын қосып, онда halyk.pay() әдісін шақыруыңыз керек.

URL TEST: https://test-epay.homebank.kz/payform/payment-api.js
URL PROD: https://epay.homebank.kz/payform/payment-api.js

halyk.cardverification() әдісіне келесі параметрлерді беру керек.


var createPaymentObject = function(auth, invoiceId, amount) {
   var paymentObject = {
           invoiceId: "000000001", 
           backLink: "https://example.kz/success.html", 
           failureBackLink: "https://example.kz/failure.html", 
           postLink: "https://example.kz/", 
           language: "rus", 
           description: "Регистрация карты",
           accountId: "testuser1", 
           terminal: "67e34d63-102f-4bd1-898e-370781d0074d", 
           amount: 0, 
           currency: "USD", 
           cardSave: true, 
           paymentType: "cardVerification" 
       };
       paymentObject.auth = auth;
       return paymentObject;
   };

   halyk.pay(createPaymentObject(auth, invoiceId, amount));

Жолы	Сипаттама
invoiceID	Тапсырыс нөмірін коммерсант жасайды, әрбір жаңа тапсырыс үшін тапсырыс нөмірі бірегей, 6-дан 15 цифрға дейін болуы керек. Егер сіздің тапсырыс нөміріңізде 6-дан астам таңба болса, онда бірегейлік қосымша соңғы 6 таңба бойынша сақталуы керек
backLink	Төлем сәтті болған кезде дүкенге оралу сілтемесі
failureBackLink	Төлем сәтсіз болған кезде дүкенге оралу сілтемесі
postLink	Төлем туралы хабарлама
language	Тілі rus/kaz/eng
description	Тапсырыс сипаттамасы, рұқсат етілген таңбалар саны 125 байт
accountId	дүкен клиентінің сәйкестендіргішін көрсетуге арналған жол, сақталған карталар тізімін алу сервисі үшін картаны сақтаған кезде (cardSave:true) міндетті болып табылады
terminal	Дүкен сәйкестендіргіші
amount	Тапсырыс сомасы
currency	Валюта
cardSave	Картаны сақтау үшін қажетті параметр
paymentType	Операция түрі - картаны тексеру

Postlink

Post Link жолында көрсетілген URL-ға хабарлама жіберіледі. Егер сіз postlink алмаған болсаңыз немесе ePay жүйесінен сұрау салуды тексеру үшін Транзакция мәртебесі сервисін пайдалануды ұсынамыз

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

{
    "id": "ffffffff-0000-000f-f000-00f0000f000f",
    "dateTime": "2020-01-01T00:00:00.00000+06:00",
    "invoiceId": "10000000001",
    "invoiceIdAlt":"8564546",
    "amount": 0,
    "currency": "USD",
    "terminal": "67e34d63-102f-4bd1-898e-370781d0074d",
    "accountId": "1",
    "description": "Регистрация карты",
    "language": "RU",
    "cardMask": "4444...4444",
    "cardType": "",
    "issuer": "Halyk bank",
    "reference": "001111111111",
    "secure": "yes",
    "tokenRecipient": "",
    "code": "ok",
    "reason": "",
    "reasonCode": 0,
    "name": "CARD HOLDER",
    "email": "ch@example.kz",
    "phone": "77777777777",
    "ip": "5.188.155.135",
    "ipCountry": "Kazakhstan",
    "ipCity": "Almaty",
    "ipRegion": "",
    "ipDistrict": "",
    "ipLongitude": 76.9293,
    "ipLatitude": 43.2638,
    "cardId": "e7e2587f-de26-4f41-ae1f-80c1fea31728"
}

Жауап кодтары

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

{
   "id": "ffffffff-0000-000f-f000-00f0000f000f",
   "dateTime": "2020-01-01T00:00:00.00000+06:00",
   "invoiceId": "10000000001",
   "amount": 0,
   "currency": "USD",
   "terminal": "999999999",
   "accountId": "1",
   "description": "Регистрация карты",
   "language": "RU",
   "cardMask": "4444...4444",
   "cardType": "",
   "issuer": "Halyk bank",
   "reference": "",
   "secure": "yes",
   "tokenRecipient": "",
   "code": "error",
   "reason": "описание ошибки",
   "reasonCode": -498,
   "name": "CARD HOLDER",
   "email": "ch@example.kz",
   "phone": "77777777777",
   "ip": "5.188.155.135",
   "ipCountry": "Kazakhstan",
   "ipCity": "Almaty",
   "ipRegion": "",
   "ipDistrict": "",
   "ipLongitude": 76.9293,
   "ipLatitude": 43.2638
}