Перейти к содержанию

🔔 Callback уведомления

После изменения статуса заявки ваша система получит POST-запрос на указанный callback_url при создании заявки(в разделе https://docs.royal-finance.org/payin/payments.html передать в тело callback_url) или который указали в лк. Пример как придет кб:

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": 10440228,
  "status": "success",
  "amount": 35005,
  "method": "card_number",
  "outter_id": null,
  "form_outter_id": null,
  "reject_reason": null,
  "geo": "Россия",
  "merchant_detail": {
    "amount": 35005,
    "amount_in_usdt": 284.0162,
    "rate": 17,
    "course": 123.25
  },
  "sum": 35005,
  "merchant": "Test_Merch",
  "created_at": "2025-11-25T10:40:55.584888+00:00",
  "updated_at": "2025-11-25T10:43:39.889147+00:00",
  "X-Request-Id": "1e5cd252-9aca-4056-8b84-247235ef3eb8",
  "callback_attempt_id": "10440228_1764067419"
}

🔄 Статусы платежей

Статус Описание
created Заявка создана, ожидает оплаты
failed Платёж отменён
refund Платёж возвращён
success Платёж успешно завершён
deleted Платёж перевели в статус удалено

📘 Описание полей Callback

Поле Тип Описание
id integer Внутренний идентификатор заявки в нашей системе.
status string Статус заявки
amount number / integer Сумма заявки
sum number / integer Сумма заявки
method string Метод оплаты все методы указаны в разделе платежей
merchant string Имя мерчанта в лк
geo string Гео
outter_id string / null Ваш внешний ID заявки которые указали в запросе при создании заявки.
form_outter_id string / null Внешний ID формы, если платёж создан через форму оплаты.
callback_attempt_id string Уникальный ID попытки отправки колбека. Меняется при каждом повторе.
X-Request-Id string Уникальный ID запроса.
reject_reason string / null Причина отказа
amount_in_usdt number Эквивалент суммы в USDT
rate number Комиссия / наценка.
course number Курс.
created_at string Дата создания заявки.
updated_at string Дата последнего изменения статуса заявки.