Transaction status

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"

Field	Description
grant_type	authorization type, client_credentials type is used for making a payment
scope	resource
client_id	ID from system ePay can be issued during after registration and conclusion of the contract
client_secret	Merchant's access key, can be obtained in the account issued upon registration
terminal	ID 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"
}

Field	Description
access_token	Operation token
expires_in	Token expiration time
refresh_token	Not used for this type of authorization
scope	Resource
token_type	Authorization 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 __

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