> For the complete documentation index, see [llms.txt](https://docs.newlandsgate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.newlandsgate.com/lichnyi-kabinet/callback.md).

# Callback

**Колбэк** — это HTTP POST-запрос, который платформа отправляет на URL мерчанта при изменении статуса заявки или других важных событиях. Это уведомление в реальном времени о состоянии заявки.

#### URL колбэка

Настраивается мерчантом во вкладке «Настройки»

<figure><img src="https://2902284824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNCPgs2UDDjLMjH7FnJzC%2Fuploads%2Fpq4QYqd88p0YKAOdueD6%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(17).png?alt=media&amp;token=ca42be28-f321-4dd5-b879-6137e3159eef" alt=""><figcaption></figcaption></figure>

#### Аутентификация

Каждый колбэк подписывается HMAC-SHA256:

* **Заголовки**:
  * `X-API-Key`
  * `X-Signature`
  * `X-Timestamp`

*Подробнее про аутентификацию в разделе «Авторизация запросов»*

### Когда отправляются колбэки

* **Завершении заявки** — когда заявка успешно завершена
* **Изменении суммы заявки** — при редактировании суммы (статус остается прежним)
* **Таймауте заявки** — когда заявка истекла
* **Других изменениях статуса** заявки

#### Версии колбэков

На данный момент реализовано несколько версий колбэков.

**Актуальная версия (V5)**:

```json
{
  "uuid": "401fcb35-8e23-49ba-acbe-b29d01febe18",
  "status": "completed",
  "type": "payout",
  "amount_usdt": 0.983,
  "amount_local": 100,
  "currency": "RUB",
  "merchant_commission": -0.098,
  "merchant_order_id": "12345",
  "receipts": ["https://..."]
}
```

*Примечание: если вы видите в колбэке другие данные, обратитесь в поддержку.*

### Базовые поля:

* `uuid` — UUID заявки
* `status` — текущий статус заявки
* `type` — тип заявки (`payout`)
* `amount_usdt` — сумма в USDT
* `amount_local` — сумма в локальной валюте
* `currency` — код валюты
* `merchant_commission` — комиссия мерчанта
* `merchant_order_id` — ID выплаты мерчанта
* `receipts` — массив URL чеков (пустой, если чеков нет)
* `reverse_callback_url` — reverse callback URL (только если передан при создании)