# Статус оплаты

Метод предназначен для оповещения системы проекта о статусе платежа.

### Backoff Policy

Для увеличения гарантий получения ответа используются BackOff-политики при выполнении запросов:

* InitialInterval = 500 \* time.Millisecond, интервалы между повторными запросами
* RandomizationFactor = 0.5,  Разброс запроса по времени между повторами 
* MaxInterval = 60 \* time.Second, Максимальное время между повторами 
* MaxElapsedTime = 10 \* time.Minute, время в течении которого будут выполнены попытки 

#### Callback платежной системой после каждой операции

После завершения оплаты, платежная система делает запрос в проект партнера для передачи состояния платежа. Запрос делается на адрес указанный в поле `callback_url` при инициации платежа.

При получении http статуса отличного от 200 транзакция будут выполнены BackOff политики

## Отправка callback-a проект партнера

<mark style="color:green;">`POST`</mark> `callback_url`&#x20;

#### Headers

| Name                                            | Type   | Description                                                                                                                    |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer  Авторотационный хэш (см [Формирование подписи](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/formirovanie-podpisi)) |

#### Request Body

| Name                                                     | Type    | Description                                                                                                         |
| -------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| created\_at<mark style="color:red;">\*</mark>            | String  | Дата создания транзакции                                                                                            |
| transaction\_id<mark style="color:red;">\*</mark>        | Integer | Идентификатор транзакции на стороне платежной системы                                                               |
| acquirer\_code<mark style="color:red;">\*</mark>         | String  | Идентификатор банка                                                                                                 |
| project\_reference\_id<mark style="color:red;">\*</mark> | String  | Идентификатор транзакции на стороне проекта                                                                         |
| project\_сlient\_id<mark style="color:red;">\*</mark>    | String  | Идентификатор пользователя на стороне проекта                                                                       |
| status\_code<mark style="color:red;">\*</mark>           | String  | [Статус транзакции](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/statusy-tranzakcii)                            |
| type\_code<mark style="color:red;">\*</mark>             | String  | [Тип транзакции](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/tipy-tranzakcii)                                  |
| amount<mark style="color:red;">\*</mark>                 | Float   | Сумма транзакции                                                                                                    |
| description<mark style="color:red;">\*</mark>            | String  | Описание                                                                                                            |
| finished\_at<mark style="color:red;">\*</mark>           | String  | Дата завершения транзакции                                                                                          |
| project\_id<mark style="color:red;">\*</mark>            | Integer | Идентификатор проекта                                                                                               |
| merchant\_id<mark style="color:red;">\*</mark>           | Integer | Идентификатор мерчанта                                                                                              |
| additional\_data                                         | Object  | Дополнительные поля                                                                                                 |
| card\_token                                              | String  | Токен карты в платежной системе                                                                                     |
| masked\_pan                                              | String  | Маскированная карта платежа                                                                                         |
| bank\_code                                               | String  | [Код ошибки](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/kody-oshibok) передается в случае ошибки в транзакции |
| bank\_message                                            | String  | Описание ошибки                                                                                                     |
| ips                                                      | String  | МПС система (visa/mastercard...)                                                                                    |
| issuer                                                   | String  | Эмитент карты                                                                                                       |

<pre class="language-json"><code class="lang-json">{
  "created_at": "2023-12-25T16:04:26.611025Z",
  "finished_at": "2023-12-25T16:05:47.672271Z",
  "transaction_id": 999,
  "acquirer_code": "jusan",
  "project_id": 999,
  "merchant_id": 999,
  "project_reference_id": "121adsf",
  "project_client_id": "12dfsd",
  "card_token": "qkRCjlJrAmbL7RMIqeS1OHGYLJpEbf7toQo/2zk+/8zCyaiQ",
  "masked_pan": "0000-00XXXXXX-0000",
  "year": "24",
  "month": "12",
  "ips": "<a data-footnote-ref href="#user-content-fn-1">VISA</a>",
  "issuer": "JSC ALLIANCE BANK",
  "status_code": "success",
  "type_code": "in",
  "amount": 100,
  "description": "Оплата заказа",
  "additional_data": {}
}
</code></pre>

[^1]: