Transaction Status

TEST URL: GET https://testepay.homebank.kz/api/check-status/payment/transaction/:invoiceid

PROD URL: GET https://epay-api.homebank.kz/check-status/payment/transaction/:invoiceid

Authorization required: client credentials

Request

Body: form-data

grant_type:"client_credentials"
scope:"webapi usermanagement email_send verification statement statistics payment"
client_id:"test"
client_secret:"yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG"
terminal:"67e34d63-102f-4bd1-898e-370781d0074d"

FieldDescription
grant_typeauthorization type, client_credentials type is used for making a payment
scoperesource
client_idID from system ePay can be issued during after registration and conclusion of the contract
client_secretMerchant's access key, can be obtained in the account issued upon registration
terminalID from system ePay can be obtained in the account, issued during registration

Ответ

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

FieldDescription
access_tokenOperation token
expires_inToken expiration time
refresh_tokenNot used for this type of authorization
scopeResource
token_typeAuthorization type
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=

HTTP CODE 200

Responce Body JSON:

{
    "resultCode": "100",
    "resultMessage": "SUCCESS",
    "transaction": {
        "id": "ef1505b2-b136-4e64-a8b5-e547b6440d6f",
        "createdDate": "2022-09-27T15:08:35.071828+06:00",
        "invoiceID": "10338026186011",
        "amount": 0,
        "amountBonus": 0,
        "payoutAmount": 0,
        "currency": "",
        "terminal": "98458031",
        "accountID": "",
        "description": "payment for order 123456",
        "language": "RU",
        "cardMask": "400303...9821",
        "cardType": "",
        "issuer": "Казкоммерцбанк",
        "reference": "227078813195",
        "intReference": "",
        "secure": false,
        "statusID": "5bbb7dd5-4691-41ee-a6a5-755a3d23a218",
        "statusName": "CHARGE",
        "name": "TEST",
        "email": "",
        "phone": "",
        "cardID": "e8a09f98-04b4-71a6-e053-1d1a000aa0d2"
    }
}


Error

{
    "resultCode": "101",
    "resultMessage": "reject",
    "transaction": null
}

__> ### resultCode __

FieldDescription
100success
101reject
102invoice not found, try again later or check transaction type (payment/p2p)
103error, try again or contact support
103field terminal absent in token