Проверка статуса перевода
Получение токена для запроса статуса перевода (для каждой операции необходимо получать и использовать оригинальный токен)
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" terminal: "67e34d63-102f-4bd1-898e-370781d0074d"
Поле | Описание |
---|---|
grant_type | тип авторизации, для проведения платежа используется тип client_credentials |
scope | ресурс |
client_id | Идентификатор коммерсанта, можно получить в кабинете, выдается при регистрации |
client_secret | Ключ доступа коммерсанта, можно получить в кабинете, выдается при регистрации |
terminal | Идентификатор точки продаж, можно получит в кабинете, выдается при регистрации |
Ответ
{
"access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
"expires_in": 7200,
"refresh_token":"",
"scope":" webapi usermanagement email_send verification statement statistics payment",
"token_type":"Bearer"
}
После получения токена, необходимо передавать его в Headers Bearer DCEB8O_ZM5U7SO_T_U5EJQ на эндпоинт:
TEST URL https://testepay.homebank.kz/api/check-status/p2p/transaction/order PROD URL https://epay-api.homebank.kz/check-status/p2p/transaction/order
Пример: https://testepay.homebank.kz/api/check-status/p2p/transaction/123456
Ответ в случае успешного выполнения запроса:
HTTP CODE 200
{
"result": {
"code": "100",
"message": "SUCCESS"
},
"transaction": {
"p2p": {
"id": "55dd8788-f222-479c-a318-fb06ad2fc090",
"createdDate": "2021-12-27T14:47:12.214471+06:00",
"invoiceID": "12345678937780",
"amount": 200,
"amountBonus": 0,
"payoutAmount": 0,
"currency": "KZT",
"cardType": "VISA",
"terminal": "98151552",
"terminalID":"c36b282f-6819-4d4f-85df-a4bdc8a8f703"
"accountID": "123",
"description": "TEST p2p",
"language": "",
"reference": "136180415044",
"intReference": "",
"secure": false,
"statusName": "CHARGE",
"reason": "",
"reasonCode": 0,
"email": "dosbols@halykbank.kz",
"phone": "",
"ip": "99999999999999999",
"ipCountry": "123",
"ipCity": "123",
"ipRegion": "123",
"ipDistrict": "123",
"ipLongitude": 123,
"ipLatitude": 123
},
"sender": {
"Name": "Sergey Frolov",
"panMask": "4003********9821",
"cardIssuer": "HomeCredit",
"cardType": "VISA",
"cardID": ""
},
"receiver": {
"Name": "Tester Petrov",
"panMask": "5578********0613",
"cardIssuer": "Halyk",
"cardType": "MasterCard",
"cardID": ""
}
}
}
Ответ в случае неуспешного выполнения запроса:
HTTP CODE 400
{
"resultCode": "102",
"resultMessage": "invoice not found, check data or try again later or check transaction type (payment/p2p",
"transaction": null
}
resultCode
Поле | Описание | Комментарий | Важно! |
---|---|---|---|
100 | Success | Успех выполнения запроса, в каком состоянии находиться платеж необходимо смотреть по statusName | ФИНАЛЬНЫЙ |
101 | Reject | Tранзакция неуспешная | ФИНАЛЬНЫЙ |
102 | Invoice not found, try again later or check transaction type (payment/p2p) | Hомер invoiceId не найден в системе, возможно ваша транзакция проходила не по сервису p2p | Статус должен быть перезапрошен как минимум в течение 20 минут после отправки изначального p2p запроса |
103 | Error, try again or contact support | Hеобходимо повторить запрос либо обратиться в службу поддержки | Если код 103 повторяется обратитесь в поддержку epay |
104 | Field terminal absent in token | Oтсутствует параметр TerminalID при запросе токена | Финальный |
107 | Try again later | Oперация в процессе выполнения, запросите статус позже | Запросите статус позднее, заказ найден, но находится в процессе обработки |
108 | Problem transaction, contact support | Tребуется сверка статуса операции с МПС Visa/Mastercard | Запросите финальный статус у поддержки epay |