Платежная страница, оплата посредством HalykID

Перед началом работы вам следует обратиться по адресу halykid@halykbank.kz для получения тестовых данных,тестового приложения и внедрения процесса получения получения кросс-авторизационного ключа homebankCasKey, который будет использоваться для дальнейшей передачи в систему ePay.

При регистрации вам будут выданы данные, которые нужно будет использовать при проведении платежа:

Получение токена для проведения оплаты (для каждой операции необходимо получать и использовать оригинальный токен)

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: ""

Ответ

{
  "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
  "expires_in": 7200,
  "refresh_token":"",
  "scope":" webapi usermanagement email_send verification statement statistics payment",
  "token_type":"Bearer"
}

Перенаправление на платежную страницу

На странице нужно подключить 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",
          autoBackLink: true,
					postLink: "https://example.kz/",
					failurePostLink: "https://example.kz/order/1123/fail",
					language: "rus",
					description: "Оплата в интернет магазине",
					accountId: "testuser1",
					terminal: "67e34d63-102f-4bd1-898e-370781d0074d",
          homebankCasKey: "66a5466d6e704ea2b9191b59b7f427dd"
					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));

Postlink

На указанный URL указанный в поле postLink будет отправлено сообщение. В случае если вы не получили postlink, или для проверки запроса от системы ePay, необходимо воспользоваться сервисом Статус транзакции

Ответ в случае успеха:

{
    "accountId": "testuser1",
    "amount": 100,
    "approvalCode": "919412",
    "cardId": "",
    "cardMask": "440043...0128",
    "cardType": "HalykId",
    "code": "ok",
    "currency": "KZT",
    "dateTime": "2025-02-12T09:42:51.960781107+05:00",
    "description": "Оплата в интернет магазине",
    "email": "",
    "id": "a2bd2222-2as2-2d2r-f22d-22a33f453a2b",
    "invoiceId": "000000001",
    "invoiceIdAlt": "8564546",
    "ip": "92.211.91.91",
    "ipCity": "",
    "ipCountry": "",
    "ipDistrict": "",
    "ipLatitude": 0,
    "ipLongitude": 0,
    "ipRegion": "",
    "issuer": "HALYK BANK",
    "language": "RUS",
    "name": "ARMAN ALI",
    "phone": "",
    "reason": "success",
    "reasonCode": 0,
    "reference": "505555555554",
    "secure": "no",
    "secureDetails": "",
    "terminal": "67e34d63-102f-4bd1-898e-370781d0074d"
}

currency

440043...0128

HalykId

ok

KZT

Оплата в интернет магазине

HALYK BANK

RUS

ARMAN ALI

success

0

no

Коды ответов

Ответ в случае неудачи:

request: {
    "accountId": "testuser1",
    "amount": 100,
    "approvalCode": "",
    "cardId": "",
    "cardMask": "",
    "cardType": "",
    "code": "error",
    "currency": "KZT",
    "dateTime": "2025-02-12T09:42:51.960781107+05:00",
    "description": "Оплата в интернет магазин",
    "email": "",
    "id": "a2bd2222-2as2-2d2r-f22d-22a33f453a2b",
    "invoiceId": "000000001",
    "invoiceIdAlt": "8564546",
    "ip": "155.55.55.55",
    "ipCity": "Shymkent",
    "ipCountry": "Kazakhstan",
    "ipDistrict": "",
    "ipLatitude": 42.5555,
    "ipLongitude": 69.55,
    "ipRegion": "",
    "issuer": "HALYK BANK",
    "language": "RUS",
    "name": "",
    "phone": "77771231212",
    "reason": "Not sufficient funds",
    "reasonCode": 484,
    "reference": "507151111111",
    "secure": "no",
    "secureDetails": "",
    "terminal": "67e34d63-102f-4bd1-898e-370781d0074d"
}

markdown

Copy

currency

error

KZT

Оплата в интернет магазине

Shymkent

Kazakhstan

42.5555

69.55

HALYK BANK

RUS

77771231212

Not sufficient funds

484

no