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

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

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

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

Статусы

Статус	Описание
Успешные
IMPLEMENTED	Исполнен
SENDED_TO_PAYER	Отправлен плательщику
Неуспешные
DECLINED_BY_PAYER	Отвергнут плательщиком
INVALIDEDS	ЭПАСП не верна
RECALL	Отозван
REFUSEDBYBANK	Отвергнут / отклонен банком
REFUSEDBYABS	Отказан АБС
REQUISITEERROR	Ошибка реквизитов
NONEACCEPTANCE	Отказ от акцепта

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

Дедупликация и смена статуса

Пара (externalId, version) определяет актуальность сообщения:

• Если externalId новый → принять.
• Если externalId совпадает, а version больше предыдущего → принять (более свежий статус).
• Если externalId и version совпадают → игнорировать (дубль).

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

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

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

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

GET /v1/payment-requests/outgoing/{externalId}/state

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

• Подключение и настройка подписки
• Вебхук-обработчик
• Безопасность

Запрос

Ответы

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

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

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

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

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

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

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

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

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

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

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

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

Loading...