Транзакция мәртебесі
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
Сұрау салу
Токенді алу
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 | Aвторизация түрі, төлем жасау үшін client_credentials түрі қолданылады |
scope | Pесурс |
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": 12.22,
"amountBonus": 0,
"payoutAmount": 10,
"orgAmount":22.22,
"approvalCode": "170243",
"data": "{\"custom_id\":\"2023.03.10-15:03:58\",\"email\":\"epay@halykbank.kz\",\"deal_number\":\"1111111\",\"offer_code\":\"1111111\",\"sum\":33900}",
"currency": "KZT",
"terminal": "98120001",
"terminalID":"67e34d63-102f-4bd1-898e-370781d0074d",
"accountID": "",
"description": "order 205218074",
"language": "RU",
"cardMask": "400303...9821",
"cardType": "VISA",
"issuer": "Казкоммерцбанк",
"reference": "231951411351",
"reason": "Successfully",
"reasonCode": "00",
"intReference": "67140D7DE97139A7",
"secure": false,
"secureDetails":"F",
"statusID": "5bbb7dd5-4691-41ee-a6a5-755a3d23a218",
"statusName": "REFUND",
"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
Жолы | Сипаттамасы | |
---|
100 | Success | Cұрау салуды орындаудың сәттілігі, төлем қандай күйде екенін statusName арқылы қарау керек |
101 | Reject | Tранзакция сәтсіз аяқталды |
102 | Invoice not found, try again later or check transaction type (payment/p2p) | Жүйеде invoiceId нөмірі табылмады, мүмкін сіздің транзакцияңыз p2p сервисі арқылы өтті |
103 | Error, try again or contact support | Cұрау салуды қайталау немесе қолдау қызметіне хабарласу қажет |
104 | Field terminal absent in token | Tокенді сұратқан кезде TerminalID параметрі жоқ |
106 | Error, incorrect terminalID | Cұрау салу кезінде қате TerminalID |
107 | In progress | Oперация орындалып жатыр, мәртебесін кейінірек сұратыңыз |
statusName
Жолы | Сипаттамасы |
---|
REFUND | Есептен шығарылған соманы қайтару жүзеге асырылды |
AUTH | Сома бұғатталған |
CANCEL | Сома бұғаттан шығарылды |
CHARGE | Сома есептен шығарылды |
VERIFIED | Тексерілді (Бұл төлем мәртебесі картаны тексеру қызметі үшін 0 USD транзакциясында қайтарылады және картаның сәтті тексерілгенін білдіреді.) |
CANCEL_OLD | Эмитент жағында авторизацияның күшін жою CHARGE/CANCEL операциясының қолданылу мерзімі аяқталған жағдайда орын алады |
FAILED | Транзакция сәтсіз аяқталды |
FINGERPRINT | бұл транзакцияның соңғы күйі емес, бұл қазіргі уақытта 3D аутентификациясына дейін деректерді жинау тексерісі жүргізіліп жатқанын білдіреді. |
3D | 3D тексеру сатысындағы қате |
NEW | Операция жасалды бірақ әзірге аралық күйде (егер сіз транзакция мәртебесін қол режимінде сұратқан кезде осы мәртебені алсаңыз, онда оның өзгеруі мүмкін екендігін ескеріңіз) |
REJECT | Төлем әрекеті сәтсіз аяқталды |