Статус транзакции

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

Требуется авторизации: client credentials

Запрос

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"
}

ПолеОписание
access_tokenТокен для проведения операции
expires_inВремя истечения токена
refresh_tokenНе используется при данном типе авторизации
scopeРесурс, для проведения платежа используется ресурс
token_typeТип авторизации
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=

HTTP CODE 200

Responce Body JSON:

{
    "resultCode": "100",
    "resultMessage": "SUCCESS",
    "transaction": {
        "id": "af2089fe-43b1-47eb-a61f-c78dd196e18d",
        "createdDate": "2022-11-15T03:52:17.289853+06:00",
        "invoiceID": "205218074",
        "amount": 22.22,
        "amountBonus": 0,
        "payoutAmount": 0,
        "currency": "KZT",
        "terminal": "98120001",
        "accountID": "",
        "description": "order 205218074",
        "language": "RU",
        "cardMask": "400303...9821",
        "cardType": "VISA",
        "issuer": "Казкоммерцбанк",
        "reference": "231951411351",
        "intReference": "67140D7DE97139A7",
        "secure": false,
        "statusID": "22eb5a3e-0737-455c-ab42-ea98f80f7963",
        "statusName": "CHARGE",
        "name": "ARMAN ALI",
        "email": "epay@halykbank.kz",
        "phone": "",
        "cardID": "e8a09f98-04b4-71a6-e053-1d1a000aa0d2",
        "xlsRRN": "",
        "ip": "46.148.239.182",
        "ipCountry": "Kazakhstan",
        "ipCity": "",
        "ipRegion": "",
        "ipDistrict": "",
        "ipLatitude": 55.7386,
        "ipLongitude": 37.6068
    }
}


Error

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

resultCode

ПолеОписание
100successуспех выполнения запроса, в каком состоянии находиться платеж необходимо смотреть по statusName
101rejectтранзакция неуспешная
102invoice not found, try again later or check transaction type (payment/p2p)номер invoiceId не найден в системе, возможно ваша трназакция проходила по сервису p2p
103error, try again or contact supportнеобходимо повторить запрос либо обратиться в службу поддержки
103field terminal absent in tokenотстусвует параметр TerminalID при запросе токена

statusName

ПолеОписание
REFUNDбыл осуществлён возврат списанной суммы
AUTHсумма в блоке
CANCELсумма разблокирована
CHARGEсумма списана
FAILEDтранзакция неуспешная
3Dошибка на стадии проверки 3D
NEWоперация создалась но пока находится в промежуточном состоянии (если вы получили этот статус при запросе статуса транзакции вручную, то примите во внимание что он может быть изменён)
REJECTнеуспешная попытка оплаты