Проверка статуса транзакции

Для получения состояния транзакции есть возможность сделать запрос по идентификатору проекта (project_id), информация о статусе хранится в поле result.transaction_status.code.

Запрос на получение статуса транзакции

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

Query Parameters

Name	Type	Description
project_reference_id*	String	Номер заказа на стороне проекта
merchant_id*	Integer	Идентификатор мерчанта присваиваемый платежной системой
project_id*	Integer	Идентификатор проекта присваиваемый платежной системой
type*	String	Тип транзакции

Headers

Name	Type	Description
Authorization*	String	Bearer Авторотационный хэш (см Формирование подписи)

200: OK Пример успешного ответа

{
  "status": true,
  "message": "Success",
  "result": {
    "finished_at": "2024-01-02T01:00:00.819045Z",
    "created_at": "2024-01-01T01:00:00.163609Z",
    "acquirer_code": "jusan",
    "acquirer_name": "Jusan Bank",
    "project_id": 99,
    "merchant_id": 999,
    "project_reference_id": "systemPayOutTest002",
    "project_client_id": "systemPayOutClient123",
    "transaction_type": {
      "code": "out",
      "name": "Вывод"
    },
    "id": 139271,
    "amount": 10,
    "description": "System PayOut Desc",
    "user_phone": "[phone]",
    "user_email": "[email protected]",
    "masked_pan": "",
    "transaction_status": {
      "code": "success",
      "name": "Транзакция прошла успешно"
    },
    "refunds" : [] // fields: amount, date.
  }
}

500: Internal Server Error Пример ответа с ошибкой

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

curl -X GET "https://prapi.tarlanpayments.kz/transaction/api/v1/system/transaction/status?merchant_id=284&project_id=81&project_reference_id=systemPayOutTest002&type=out" -H "accept: application/json" -H "Authorization: 3f37e1bc02ebe3b4b38612dea390c237de2a9e55c7083fe16bd32cc28662af4a"