Дисклеймер

QR коды жасалғаннан кейін 20 минуттан кейін, егер QR кодқа соңғы мәртебе берілмесе (PAID, REJECTED), онда QR коды жойылады және оны төлеу мүмкін емес және транзакция бас тартылған (REJECTED)деп белгіленеді

1. Токен генерациясы

Request

TEST URL POST https://test-epay-oauth.epayment.kz/oauth2/token 
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token

Body: form-data

grant_type: "client_credentials"
client_id: "CLIENTID"
client_secret: "CLIENTSECRET"
scope: "webapi usermanagement email_send verification statement statistics payment"
terminal: "TERMINALID"
invoiceID: "invoiceID"
amount: "100"
currency: KZT

Кіріс параметрлері

Response

{
    "access_token": "access token",
    "expires_in": "1200",
    "refresh_token": "",
    "scope": "payment",
    "token_type": "Bearer"
}

Жауап деректері:

2. QR генерациясы

Request

TEST URL POST https://test-epay-api.epayment.kz/payment/qr/generate  
PROD URL POST https://epay-api.homebank.kz/payment/qr/generate 
Авторизация: Алдыңғы қадамда қол жетімділік белгісі бар Bearer тақырыбы.
Payload:
Payload түрі: JSON

Body: form-data

{
  "accountId": "your account id",
  "payerEmail": "payer@mail.com",
  "payerPhone": "87777777777",
  "postLink": "https://example.com/postlink",
  "failurePostLink": "https://example.com/failurepostlink",
  "description": "payment purpose",
  "data": "",
  "language": "ru"
}

Кіріс параметрлері

Response

{
  "qrcode": "qr code",
  "homebankLink": "homebank deeplink",
  "onlinebankLink": "online bank deeplink",
  "status": "NEW",
  "billNumber": 123456
}

Жауап деректері:

Ықтимал қате кодтары

3. Төлем мәртебесін алу

Request

TEST URL GET https://test-epay-api.epayment.kz/qr  
PROD URL GET https://epay-api.homebank.kz/qr 
Authorization: QR генерациясында қолданылатын кіру таңбалауышы бар Bearer тақырыбы.
Payload: Бос.

Response

{
    "qrcode": "00020101021227400012KZ.HALYKBANK0108HSBKKZKX02089830130028660011477859186730120KZ8160101310001554340208983013000301N0501006010520447845303398540420005802KZ5907KINO.KZ6006ALMATY62380111477859186730803191101204074000842363046CA2",
    "status": "NEW",
    "reference": "",
    "cardId": "",
    "cardType": "",
    "cardMask": "",
    "trType": "LOCALQR",
    "secure3D": false,
    "openwayId": "",
    "issuer": "HSBKKZKX",
    "issuerBankCountry": "KZ",
    "fee": 0,
    "amount": 2000,
    "currency": "KZT",
    "paymentChannel": "",
    "errDescription": "",
    "retCode": ""
}

Жауап деректері:

QR төлемін қайтару

1. Токен генерациясы

TEST URL POST https://test-epay-oauth.epayment.kz/oauth2/token 
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token

Body: form-data

grant_type: "client_credentials"
client_id: "CLIENTID"
client_secret: "CLIENTSECRET"
scope: "webapi usermanagement email_send verification statement statistics payment"
currency: KZT

Кіріс параметрлері

Response

{

    "access_token": "access token",
    "expires_in": "1200",
    "refresh_token": "",
    "scope": "payment",
    "token_type": "Bearer"
}

Жауап деректері:

2. Қайтару жүргізу

Толығырақ: https://epayment.kz/docs/vozvrat-chastichnyi-vozvrat

Check status QR төлем сипаттамасы

https://epayment.kz/docs/check-status-payment

Төлем немесе қайтару туралы ақпаратты алу жауаптағы бір өрісті қоспағанда, құжаттамадағыдай болады. Транзакция объектісінде QR транзакциялары үшін қосымша "paymentType" өрісі беріледі: "QR".