Төлем картасын сақтау
Тіркелу кезінде сізге төлем жасау кезінде пайдалану қажет мәліметтер беріледі:
| |
|---|
| 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/27 | 321 | unlock |
| 5522042705066736 | 01/27 | 775 | unlock |
| 377514500004820 | 01/28 | 0198 | 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: "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 | Операция түрі - картаны тексеру |
| ip | IP сұрау қайдан келді |
| ipCountry | ел атауы |
| ipCity | қала атауы |
| ipRegion | Аймақ атауы |
| ipDistrict | аудан атауы |
| ipLatitude | ендік |
| ipLongitude | бойлық |
Postlink
Post Link жолында көрсетілген URL-ға хабарлама жіберіледі.
Егер сіз postlink алмаған болсаңыз немесе ePay жүйесінен сұрау салуды тексеру үшін Транзакция мәртебесі сервисін пайдалануды ұсынамыз
Сәттілік жағдайындағы жауап:
{
"acountId":"9398101000014416472",
"amount":800,
"approvalCode":"178644",
"cardId":"2cd0fb54-9855-14a6-e063-1b01010a84c4",
"cardMask":"440043...0128",
"cardType":"VISA",
"code":"ok",
"currency":"KZT",
"dateTime":"2025-02-12T09:42:51.960781107+05:00",
"description":"ONAY!",
"email":"",
"id":"a1bd0589-3ac9-4a2e-a31d-67a33f453a2b",
"invoiceId":"33456850",
"ip":"91.215.96.94",
"ipCity":"",
"ipCountry":"",
"ipDistrict":"",
"ipLatitude":0,
"ipLongitude":0,
"ipRegion":"",
"issuer":"JSC KASPI BANK",
"language":"RUS",
"name":"",
"phone":"77775903128",
"reason":"success",
"reasonCode":0,
"reference":"504355533594",
"secret_hash":"ZitLN1VLd21hUnFOSTJKbmg0UVdYVm8z",
"secure":"yes",
"secureDetails":"F",
"terminal":"9d40257c-bdfc-4c5e-9c3c-0c2a16bfc5a4"
}
Жауап кодтары
Сәтсіздік болған жағдайдағы жауап:
{
"accountId":"9398101000006384023",
"amount":200,
"approvalCode":"",
"cardId":"",
"cardMask":"",
"cardType":"",
"code":"error",
"currency":"KZT",
"dateTime":"2025-02-12T09:42:53.036675+05:00",
"description":"ONAY!",
"email":"",
"id":"03c6de6e-0028-42fa-9199-561d78e59789",
"invoiceId":"33456910",
"ip":"95.82.119.153",
"ipCity":"Almaty",
"ipCountry":"Kazakhstan",
"ipDistrict":"",
"ipLatitude":43.2638,
"ipLongitude":76.9293,
"ipRegion":"",
"issuer":"JSC KASPI BANK",
"language":"RUS",
"name":"",
"phone":"77476080308",
"reason":"Authentication failed",
"reasonCode":473,
"reference":"",
"secret_hash":"T1hDaWhlay9NUysxRTA2djFFZnpTVDNU",
"secure":"no",
"secureDetails":"",
"terminal":"9d40257c-bdfc-4c5e-9c3c-0c2a16bfc5a4"
}