Уведомление о финальном статусе РПП

Обновлено 11 августа 2026

Доступно только для набора «Компаниям»

Вебхук позволяет получать финальные статусы рублевых платежных поручений (РПП). Когда документ достигает конечного состояния на стороне банка (исполнен, отклонен, отозван и т.д.), система отправляет уведомление на ваш endpoint.

Промежуточные статусы не отправляются. Событие приходит только при наступлении финального состояния.

Статусы

Статус	Описание
Успешные
IMPLEMENTED	Исполнен
Неуспешные
DELETED	Удален
INVALIDEDS	ЭП/АСП не верна
RECALL	Отозван
REFUSEDBYBANK	Отвергнут / отклонен банком
REFUSEDBYABS	Отказан АБС
REQUISITEERROR	Ошибка реквизитов
REFUSED_BY_RZK	Отказан контролирующей организацией
FRAUDDENY	Отвергнут ФРОД

Правила обработки:

Дедупликация и смена статуса: Идентификатор externalId определяет документ. Актуальность сообщения определяется по полю eventTime:

• Если externalId новый → принять
• Если externalId совпадает, а eventTime более позднее, чем у ранее полученного → принять (более свежий статус)
• Если externalId и bankStatus совпадают с ранее полученными → игнорировать (дубль)

Обработка недоставленных событий: Если по истечении суток с момента создания РПП вебхук не получен, следует запросить статус через API синхронного запроса.

Ответ на вебхук

Для подтверждения получения события необходимо вернуть 2xx без тела. Если возвращен один из статусов: 408, 409, 429, 500, 502, 503, 504, 507, 508 или 509, Банк сочтет доставку неуспешной и предпримет повторную попытку.

Обработка недоставленных событий

Если по истечении суток с момента создания РПП вебхук не получен, следует запросить статус через API:

GET /v1/payments/{externalId}/state

Полезные ссылки:

• Подключение и настройка подписки
• Требования к вебхук-обработчику
• Рекомендации по безопасности

Запрос

Ответы

Успешное получение и обработка вебхука.

Для подтверждения получения события необходимо вернуть HTTP статус 2xx. Тело ответа может быть пустым.

Таймаут запроса. Банк предпримет повторную попытку доставки.

Конфликт при обработке. Банк предпримет повторную попытку доставки.

Слишком много запросов. Банк предпримет повторную попытку доставки.

Внутренняя ошибка сервера получателя. Банк предпримет повторную попытку доставки.

Ошибка шлюза. Банк предпримет повторную попытку доставки.

Сервис недоступен. Банк предпримет повторную попытку доставки.

Таймаут шлюза. Банк предпримет повторную попытку доставки.

Недостаточно места на диске. Банк предпримет повторную попытку доставки.

Обнаружено зацикливание. Банк предпримет повторную попытку доставки.

Превышен лимит трафика. Банк предпримет повторную попытку доставки.

Loading...