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

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

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

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

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

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

Параметр

Тип

Описание

clientOrderIdClientTransactionNumber

Идентификатор операции, полученный от системы контрагента в запросе на зачисление перевода (makeDeposition).

requestDTxs:dateTime

Дата и время формирования запроса операции на стороне и по часам Яндекс.Денег.

dstAccountYMAccount

Идентификатор получателя перевода.

amountCurrencyAmount

Сумма перевода, например: 12.34.

currencyCurrencyCode

Код валюты перевода. Возможные значения:

  • 643 — российский рубль;
  • 10643 — рубли в тестовой среде Яндекс.Денег.
errorxs:string

Код ошибки операции

Параметр

Тип

Описание

clientOrderIdClientTransactionNumber

Идентификатор операции, полученный от системы контрагента в запросе на зачисление перевода (makeDeposition).

requestDTxs:dateTime

Дата и время формирования запроса операции на стороне и по часам Яндекс.Денег.

dstAccountYMAccount

Идентификатор получателя перевода.

amountCurrencyAmount

Сумма перевода, например: 12.34.

currencyCurrencyCode

Код валюты перевода. Возможные значения:

  • 643 — российский рубль;
  • 10643 — рубли в тестовой среде Яндекс.Денег.
errorxs:string

Код ошибки операции

Пример запроса
<?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"/>

Формат ответа контрагента

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

Параметр

Тип

Описание

statusxs:int

Результат выполнения операции. Уведомление считается доставленным, если в ответе приходит статус Успех (status=0). В остальных случаях Яндекс.Деньги будут повторять попытки доставки уведомления.

clientOrderIdClientTransactionNumber

Копия параметра clientOrderId запроса.

processedDTxs:dateTime

Время обработки запроса по часам Яндекс.Денег.

Параметр

Тип

Описание

statusxs:int

Результат выполнения операции. Уведомление считается доставленным, если в ответе приходит статус Успех (status=0). В остальных случаях Яндекс.Деньги будут повторять попытки доставки уведомления.

clientOrderIdClientTransactionNumber

Копия параметра clientOrderId запроса.

processedDTxs:dateTime

Время обработки запроса по часам Яндекс.Денег.

Пример ответа
<?xml version="1.0" encoding="UTF-8"?>
<errorDepositionNotificationResponse clientOrderId="12345" 
                        status="0"
                        processedDT="2011-07-01T20:38:01.000Z"/>

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

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

Смотрите также

Коды состояний запроса

Коды ошибок

Типы данных