Verification of transaction status

To get the transaction status, it is possible to query by project_id, the status information is stored in the result.transaction_status.code field.

Request to receive the transaction status

GET https://prapi.tarlanpayments.kz/transaction/api/v1/system/transaction/status

Query Parameters

Name	Type	Description
project_reference_id*	String	Order number on the project side
merchant_id*	Integer	Merchant ID assigned by the payment system
project_id*	Integer	Project ID assigned by the payment system
type*	String	Type of transaction

Headers

Name	Type	Description
Authorization*	String	Bearer Auto-rotation hash (see Signature Creating)

500: Internal Server Error Example of an error response

{
    "status": false,
    "status_code": 5103,
    "message": "transaction not found",
    "result": {}
}

200: OK Example of a successful response

{
    "status": true,
    "message": "Success",
    "result": {
        "id": 99999,
        "amount": 10,
        "description": "test",
        "user_phone": "87757715130",
        "user_email": "[e-mail]",
        "card_token": "sdfasdf23",
        "masked_pan": "0000-00XXXXXX-0000",
        "bank_code": "0", 
        "bank_message": ""
        "additional_data": {
            "abc": "111",
            "lkk": "123"
        },
        "transaction_status": {
            "code": "success",
            "name": "Транзакция прошла успешно"
        },
        "bank_reference_id": "100885",
        "created_at": "2023-10-04T10:05:02.93843Z",
        "transaction_type": {
            "code": "out",
            "name": "Вывод"
        },
        "refunds" : [] // fields: amount, date.
    }
}

curl --location 'https://prapi.tarlanpayments.kz/transaction/api/v1/system/transaction/status?merchant_id=1&project_id=42&project_reference_id=sanch92116&type=in' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer sign'