Уведомление о неуспешном переводе (errorDepositionNotification)

Это старая версия API. Переходите на API ЮKassa.

С помощью запроса errorDepositionNotification ЮKassa сообщает вам о неуспешном статусе перевода на банковский счет или мобильный телефон и возврате выплаты.

Случаи возвратов:

для перевода на банковский счет:
- банк отверг перевод, необходимо проверить корректность реквизитов;
- паспортные данные получателя не прошли проверку;
для перевода на мобильный телефон: оператор сотовой связи отверг перевод.

Формат запроса ЮKassa

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

Параметр	Тип	Описание
clientOrderId	ClientTransactionNumber	Идентификатор операции, который ЮKassa получила в запросе на зачисление перевода (`makeDeposition`).
requestDT	xs:dateTime	Дата и время формирования запроса операции на стороне и по часам ЮKassa.
dstAccount	YMAccount	Идентификатор получателя перевода.
amount	CurrencyAmount	Сумма перевода, например: `12.34`.
currency	CurrencyCode	Код валюты перевода. Возможное значение — `643` (российский рубль).
error	xs:string	Код ошибки операции

Пример запроса

XML

<?xml version="1.0" encoding="UTF-8"?>
<errorDepositionNotificationRequest clientOrderId="12345"
                       requestDT="2011-07-01T20:38:00.000Z"
                       dstAccount="410011234567"
                       amount="10.00"
                       currency="643"
                       error="31"/>

Формат ответа вашей системы

Параметры ответа

Параметр	Тип	Описание
status	xs:int	Результат выполнения операции. Уведомление считается доставленным, если в ответе приходит статус Успех (`status=0`). В остальных случаях ЮKassa будет повторять попытки доставки уведомления.
clientOrderId	ClientTransactionNumber	Копия параметра `clientOrderId` запроса.
processedDT	xs:dateTime	Время обработки запроса по часам ЮKassa.

Пример ответа

XML

<?xml version="1.0" encoding="UTF-8"?>
<errorDepositionNotificationResponse clientOrderId="12345"
                        status="0"
                        processedDT="2011-07-01T20:38:01.000Z"/>

Правила обработки запроса

Уведомление о неуспешном статусе перевода ЮKassa передает отдельным HTTP-запросом, содержащим криптопакет формата PKCS#7. На каждое уведомление следует отвечать сообщением о результате операции, помещенным в криптопакет PKCS#7. Правила формирования запроса и ответа определены в разделе Формат взаимодействия. ЮKassa отправляет уведомление на адрес контактного лица по техническим вопросам, который указан в личном кабинете ЮKassa или в технической анкете (errorDepositionNotificationURL).
Отвечать на запросы ЮKassa следует в течение 10 секунд. Уведомление считается доставленным, если в ответе вашей системы приходит статус Успех (status=0).
При длительном многократном отсутствии ответа вашей системы (либо при многократных технических ошибках) ЮKassa будет повторять попытки доставки уведомления в течение суток: первый раз — через 2 минуты, потом через 4, 10 и далее, с увеличением интервала.
Уведомление содержит идентификатор операции (clientOrderId), который вы передали в запросе на зачисление перевода (makeDeposition).

Что почитать еще

Коды состояний запроса Коды ошибок Типы данных