# Транзакция мәртебесін тексеру

Транзакция күйін алу үшін жоба идентификаторы (project\_id) арқылы сұрау жасауға болады, күй туралы ақпарат нәтиже transaction\_status.code өрісінде сақталады.

## Транзакция мәртебесін алуға сауал

<mark style="color:blue;">`GET`</mark> `https://prapi.tarlanpayments.kz/transaction/api/v1/system/transaction/status`

#### Query Parameters

| Name                                                     | Type    | Description                                   |
| -------------------------------------------------------- | ------- | --------------------------------------------- |
| project\_reference\_id<mark style="color:red;">\*</mark> | String  | Жоба жағындағы тапсырыс нөмірі                |
| merchant\_id<mark style="color:red;">\*</mark>           | Integer | Төлем жүйесі беретін мерчант сәйкестендіргіші |
| project\_id<mark style="color:red;">\*</mark>            | Integer | Төлем жүйесі беретін жобаның сәйкестендіргіші |
| type<mark style="color:red;">\*</mark>                   | String  | Транзакция типі                               |

#### Headers

| Name                                            | Type   | Description                                                                                                                             |
| ----------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer  Авторотациялық хэш ([Қолтаңбаны қалыптастыруға ](https://docs.tarlanpayments.kz/az/t-lem-shlyuzi/olta-bany-alyptastyru)қараңыз) |

{% tabs %}
{% tab title="500: Internal Server Error Қатесі бар жауап үлгісі" %}

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

{% endtab %}

{% tab title="200: OK Сәтті жауап үлгісі" %}

<pre class="language-json" data-overflow="wrap"><code class="lang-json">{
    "status": true,
    "message": "Success",
    "result": {
        "id": 99999,
        "amount": 10,
        "description": "test",
        "user_phone": "87757715130",
        "user_email": "test@inbox.ru",
        "card_token": "sdfasdf23",
        "masked_pan": "0000-00XXXXXX-0000",
        "bank_code": "0", <a data-footnote-ref href="#user-content-fn-1">Код ошибки</a>
        "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.
}
</code></pre>

{% endtab %}
{% endtabs %}

```bash
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'
```

[^1]: [Код ошибки](https://docs.tarlanpayments.kz/az/t-lem-shlyuzi/k-mekshi-dister/broken-reference) передается в случае ошибки в транзакции