Webhook выплаты

Наша система имеет возможность уведомления об изменении статуса выплаты которая создана через API.
Вам требуется добавить необходимый URL для отправки http-уведомлений на странице API Ключей, либо добавить URL при создании выплаты.

INFO

Уведомления отправляются только в случае выполнения либо отклонения выплаты (status: success, fail)

Запрос

Заголовоки запроса

Content-Type: application/json
X-Signature: {signature}

В заголовке X-Signature содержится сигнатура подтверждающая валидность (подробнее в инструкции по формированию сигнатуры).

Параметры запроса

Имя поля	Тип поля	Описание
payoff_id	string format: uuid	ID выплаты
order_id	string nullable: true	ID платежа в вашей системе
service	string	Метод выплаты
payoff_data	object example: {}	Дополнительные данные выплаты (для СБП и Мобильной связи РФ)
payoff_data.sbp_bank_label	string	Название банка СБП (обязательно для СБП)
payoff_data.mobile_ru_operator_label	string	Название мобильного оператора РФ (обязательно для Мобильной связи РФ)
wallet	string	Номер карты/телефона/кошелька для выплаты
status	string enum: [success, fail]	Статус выплаты Варианты: success - Выполнена fail - Отклонена
amount	number format: double	Сумма к выплате в рублях
commission	number format: double	Комиссия в рублях
currency	string	Валюта платежа
amount_in_currency	number format: float	Сумма к выплате в указаной валюте платежа
amount_rate	number format: double	Курс конвертации рублей в валюту платежа. Параметр передается если валюта платежа не RUB
error_message	string nullable: true	Причина отклонения выплаты. Параметр передается если статус выплаты Отклонена
created_at	string format: datetime [Y-m-d H:i:s]	Дата создания выплаты UTC+0
complete_at	string format: datetime [Y-m-d H:i:s]	Дата выполнения либо отклонения выплаты UTC+0

Пример параметров запроса:

json

{
    "payoff_id": "24f48f28-4b02-42c7-ad0e-ab14ec7a7d05",
    "order_id": null,
    "service": "mobile.ru",
    "payoff_data": {
        "mobile_ru_operator_label": "Мегафон"
    },
    "wallet": "******",
    "status": "success",
    "amount": 1000,
    "commission": 50,
    "currency": "RUB",
    "amount_in_currency": 1000,
    "created_at": "2025-08-10 08:46:30",
    "complete_at": "2025-08-10 11:48:25"
}

Ответ от сервера

От вас нужен успешный HTTP ответ 200. Тело ответа не обязательно.
Рекомендуем так-же проверять IP сервера отправляющего Вам информацию, наши IP: 37.27.193.34, 159.69.50.37.

Webhook выплаты ​

Запрос ​

Заголовоки запроса ​

Параметры запроса ​

Пример параметров запроса: ​

Ответ от сервера ​

Рекомендация по обработке Webhook ​