Платежная страница
При регистрации вам будут выданы данные, которые нужно будет использовать при проведении платежа:
| |
---|
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 |
Test payment card
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"
secret_hash: "HelloWorld123#"
amount: 100
currency: "KZT"
terminal: "67e34d63-102f-4bd1-898e-370781d0074d"
postLink: ""
failurePostLink: ""
Поле | Описание |
---|
grant_type | тип авторизации, для проведения платежа используется тип client_credentials |
scope | ресурс |
client_id | Идентификатор коммерсанта, можно получить в кабинете, выдается при регистрации |
client_secret | Ключ доступа коммерсанта, можно получить в кабинете, выдается при регистрации |
invoiceID | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр. Если ваш номер заказа содержит более 6 цифр, то дополнительно уникальность должна соблюдаться по последним 6ти цифрам |
secret_hash | дополнительное секретное значение(строка), сгенерированное системой интернет-магазина, которое будет возвращено на Postlink, ОБЯЗАТЕЛЬНОЕ ЗНАЧЕНИЕ |
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.pay() нужно передать следующие параметры.
var createPaymentObject = function(auth, invoiceId, amount) {
var paymentObject = {
invoiceId: "000000001",
invoiceIdAlt:"8564546",
backLink: "https://example.kz/success.html",
failureBackLink: "https://example.kz/failure.html",
postLink: "https://example.kz/",
failurePostLink: "https://example.kz/order/1123/fail",
language: "rus",
description: "Оплата в интернет магазине",
accountId: "testuser1",
terminal: "67e34d63-102f-4bd1-898e-370781d0074d",
amount: 100,
data: "{\"statement\":{\"name\":\"Arman Ali\",\"invoiceID\":\"80000016\"}}",
currency: "KZT",
phone: "77777777777",
name:"Arman Ali",
email: "example@example.com"
};
paymentObject.auth = auth;
return paymentObject;
};
halyk.pay(createPaymentObject(auth, invoiceId, amount));
Поле | Описание |
---|
invoiceId | Номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр. Если ваш номер заказа содержит более 6 цифр, то дополнительно уникальность должна соблюдаться по последним 6ти цифрам |
invoiceIdAlt | дополнительный номер заказа, генерируется коммерсантом, должен быть уникальный для каждого нового заказа,от 6 до 15 цифр |
backLink | Ссылка для возврата в магазин при удачном платеже |
failureBackLink | Ссылка для возврата в магазин при не удачном платеже |
postLink | Уведомление о платеже |
failurePostLink | Уведомление о неудачном платеже, если не заполнено, то информация будет отправлена на адрес указанный в postLink |
language | Язык rus/kaz/eng |
description | Описание заказа, допустимое количество символов 125 байтов |
accountId | поле для указания идентификатора клиента магазина, обязателен при сохранений карты (cardSave:true) для сервиса получения списка сохраненных карт |
terminal | Идентификатор магазина |
amount | Сумма заказа |
currency | Валюта |
phone | номер телефона клиента (не обязательно) |
name | имя плательщика, только на латинице (не обязательно) |
email | email клиента (не обязательно) |
auth | Токен / передается полностью как объект, все данные полученные от epay по запросу токена |
data | дополнительное поле транслируется в отчете при заполнении (не обязательно) |
Postlink
На указанный URL указанный в поле postLink будет отправлено сообщение.
В случае если вы не получили postlink, или для проверки запроса от системы ePay, необходимо воспользоваться сервисом Статус транзакции
Ответ в случае успеха:
{
"accountId": "sad12eqsda",
"amount": 100,
"approvalCode": "157911",
"cardId": "11f1111b-f151-6f11-e161-1111010a2111",
"cardMask": "440043...2222",
"cardType": "VISA",
"code": "ok",
"currency": "KZT",
"dateTime": "2024-07-29T10:50:56.765674319+05:00",
"description": "Arman Alimguzhinov",
"email": "",
"id": "1d1a11f1-1111-111c-1113b-e8340ce51111",
"invoiceId": "191111111",
"ip": "213.148.6.204",
"ipCity": "",
"ipCountry": "",
"ipDistrict": "",
"ipLatitude": 0,
"ipLongitude": 0,
"ipRegion": "",
"issuer": "JSC KASPI BANK",
"language": "RUS",
"name": "STANDARD CARDHOLDER",
"phone": "",
"reason": "success",
"reasonCode": 0,
"reference": "411111111117",
"secure": "no",
"secureDetails":"F",
"terminal": "67e34d63-102f-4bd1-898e-370781d0074d"
}
Коды ответов
Ответ в случае неудачи:
{
"id": "ffffffff-0000-000f-f000-00f0000f000f",
"dateTime": "2020-01-01T00:00:00.00000+06:00",
"invoiceId": "10000000001",
"invoiceIdAlt":"8564546",
"amount": 100,
"currency": "KZT",
"terminal": "67e34d63-102f-4bd1-898e-370781d0074d",
"accountId": "1",
"description": "Оплата в интернет магазине",
"language": "RU",
"cardMask": "4444...4444",
"cardType": "",
"issuer": "Halyk bank",
"reference": "",
"secure": "no",
"secureDetails":"F",
"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
}