Проверка статуса перевода
Получение токена для запроса статуса перевода (для каждой операции необходимо получать и использовать оригинальный токен)
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" 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://test-epay-api.epayment.kz/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": "test@halykbank.kz", "phone": "", "ip": "99999999999999999", "ipCountry": "123", "ipCity": "123", "ipRegion": "123", "ipDistrict": "123", "ipLongitude": 123, "ipLatitude": 123 }, "sender": { "Name": "Tester Petrov", "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 }
| Field | Description |
|---|---|
| resultCode | Код результата операции |
| resultMessage | Описание результата |
| transaction | Данные о транзакции |
resultCode
| Поле | Описание | |
|---|---|---|
| 100 | Success | Успех выполнения запроса, в каком состоянии находиться платеж необходимо смотреть по statusName |
| 101 | Reject | Tранзакция неуспешная |
| 102 | Invoice not found, try again later or check transaction type (payment/p2p) | Hомер invoiceId не найден в системе, возможно ваша траhзакция проходила по сервису p2p |
| 103 | Error, try again or contact support | Hеобходимо повторить запрос либо обратиться в службу поддержки |
| 104 | Field terminal absent in token | Oтстусвует параметр TerminalID при запросе токена |
| 106 | Error, incorrect terminalID | Hекорректный TerminalID при запросе токена |
| 107 | In progress | Операция в процессе выполнения, запросите статус позже |
| 108 | problem transaction, contact support | Нефинальный! Требуется сверка с МПС, обратитесь в epay@halykbank.kz |
| 109 | Terminal does not belong to the client, check provided request | Терминал не принадлежит клиенту, проверьте предоставленный запрос |