P2P CHECK STATUS

Getting a token to request the transfer status (for each operation, you need to get and use the original token)

TEST URL POST https://testoauth.homebank.kz/epay2/oauth2/token
PROD URL POST https://epay-oauth.homebank.kz/oauth2/token

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	Аuthorization type, the client_credentials
scope type is used for making a payment	Resource
client_id	Merchant ID, can be obtained in the cabinet, issued during registration
client_secret	The merchant's access key, which can be obtained in the cabinet, is issued upon registration
terminal	The ID of the point of sale, which can be obtained in the cabinet, is issued during registration

Response

{
"access_token": "DCEB8O_ZM5U7SO_T_U5EJQ",
"expires_in": 7200,
"refresh_token": "",
"scope": "webapi usermanagement email_send verification statement statistics payment",
"token_type": "Bearer"
}

After receiving the token, you need to transfer it to Headers Bearer DCEB8O_ZM5U7SO_T_U5EJQ on the endpoint:

TEST URL https://testepay.homebank.kz/api/check-status/p2p/transaction/order
PROD URL https://epay-api.homebank.kz/check-status/p2p/transaction/order

Example: https://testepay.homebank.kz/api/check-status/p2p/transaction/123456

Response in case of successful execution of the request:

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

Response in case of unsuccessful execution of the request:

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	Operation result code
result Message	Description of the result
transaction	Transaction data

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
104	Field terminal absent in token
107	Try again later
109	Terminal does not belong to the client, check provided request