Это старая версия API. Переходите на API ЮKassa.
С помощью запроса
errorDepositionNotification
ЮKassa сообщает вам о неуспешном статусе перевода на банковский счет или мобильный телефон и возврате выплаты.Случаи возвратов:
- для перевода на банковский счет:
- банк отверг перевод, необходимо проверить корректность реквизитов;
- паспортные данные получателя не прошли проверку;
- для перевода на мобильный телефон: оператор сотовой связи отверг перевод.
| Параметр | Тип | Описание |
|---|---|---|
| clientOrderId | ClientTransactionNumber | Идентификатор операции, который ЮKassa получила в запросе на зачисление перевода ( makeDeposition ). |
| requestDT | xs:dateTime | Дата и время формирования запроса операции на стороне и по часам ЮKassa. |
| dstAccount | YMAccount | Идентификатор получателя перевода. |
| amount | CurrencyAmount | Сумма перевода, например: 12.34 . |
| currency | CurrencyCode | Код валюты перевода. Возможное значение — 643 (российский рубль). |
| error | xs: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"/>
| Параметр | Тип | Описание |
|---|---|---|
| status | xs:int | Результат выполнения операции. Уведомление считается доставленным, если в ответе приходит статус Успех ( status=0 ). В остальных случаях ЮKassa будет повторять попытки доставки уведомления. |
| clientOrderId | ClientTransactionNumber | Копия параметра clientOrderId запроса. |
| processedDT | xs:dateTime | Время обработки запроса по часам ЮKassa. |
<?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).