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

Обновлено 1 октября 2026

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

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

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

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

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

Статусы

Статус	Описание
Успешные
IMPLEMENTED	Исполнен
Неуспешные
DELETED	Удален
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/pay-doc-cur/{externalId}/state

Запрос

Ответы

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

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

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

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

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

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

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

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

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

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

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

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

Loading...