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
).
See also