Notification of unsuccessful transfer (errorDepositionNotification)

This is an old version of the API. Switch to the YooMoney API.

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

Conditions for returns:

for transfers to a bank account:
- bank declined payout; need to check account information;
- recipient’s passport information didn’t pass verification;
for a deposit to a mobile phone: the mobile carrier declined the payout.

Request format

Request parameters

Parameter	Type	Description
clientOrderId	ClientTransactionNumber	ID of the operation received from your system in the request for funds deposit (`makeDeposition`).
requestDT	xs:dateTime	The date and time the operation request was executed on the YooMoney side, according to their system.
dstAccount	YMAccount	Identifier of the transfer recipient.
amount	CurrencyAmount	The transfer amount. For example: `12.34`.
currency	CurrencyCode	Currency code of the transfer. Possible value — `643` (Russian ruble).
error	xs:string	Operation error code

Request example

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"/>

Response format

Response parameters

Parameter	Type	Description
status	xs:int	Result of executing the operation. The notification is considered delivered if the response contains the status Success (`status=0`). In all other cases, YooMoney repeats the attempt to deliver the notification.
clientOrderId	ClientTransactionNumber	A copy of the `clientOrderId` request parameter.
processedDT	xs:dateTime	Time when the request was processed, according to the YooMoney server.

Example of the response

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

Rules for request processing

The YooMoney service passes the notification of a failed transfer in a separate HTTP request containing a PKCS#7 cryptographic message. For each notification, you should respond with a message about the operation result placed in a PKCS#7 cryptographic message. The rules for forming the request and response are defined in the section Interaction format. The YooMoney sends the notification to the address of the technical contact that is specified in the YooMoney Merchant Profile or in the technical questionnaire (errorDepositionNotificationURL).
You should respond to YooMoney requests within 10 seconds. A notification is considered delivered if the status Success (status=0) is received in your response.
If a response from your system is not received over a prolonged period (or if repeated technical errors occur), YooMoney will continue trying to deliver the notification over the next 24 hours. The first attempt is after 2 minutes, then after 4 minutes, after 10, and so on, with increasing intervals.
The notification contains the operation ID (clientOrderId) received from you in the request for funds deposit (makeDeposition).