# Callback

Криптобанк отправит запрос на указанный вами url, когда статус созданной вами заявки изменится на успешно выполненную или отменённую.

Пример ответа

```json
{
    "currency":  "USDT-TRX",   
    "id":  "374",   
    "status":  "SUCCESS",
    "sum":  "185",   
    "sum_currency":  "186",   
    "verify_hash":  "SECRET_HASH"     
}
```

* id — идентификатор заявки в криптобанке, который вы сохранили после запроса на покупку.
* verify\_hash — подпись сообщения, которая позволит вам убедиться, что запрос поступил именно от криптобанка.

Обратите внимание, что сумма в USDR \<sum> и сумма в валюте \<sum\_currency> могут отличаться от значений, установленных при создании транзакции (например, если конечный пользователь перечислил сумму, отличающуюся от установленной).

Удостоверьтесь, что ваш код корректно обрабатывает значение каждого возвращаемого параметра.

Возможные значения поля status:

* SUCCESS — транзакция оплачена
* CANCEL — транзакция отменена

Проверка verify\_hash (пример на PHP):

```php
$data = $_POST;
unset($data['verify_hash']);
ksort($data);
$dataString = serialize($data);
$checkKey = hash_hmac('sha1', $dataString, CALLBACK_API_KEY);
    
if ($checkKey != $_POST[''verify_hash'']) {
  return false;
}
```

Ожидаемый ответ, в случае успешной обработки события:

```json
{
   "success":  true
}
```

В случае иного ответа, криптобанк продолжит отправлять запрос до получения правильного ответа, либо до достижения лимита, установленного в настройках API.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.relictum.pro/ru/razrabotka-integraciya/api-relictum-finance/callback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.