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 |