Notification of unsuccessful transfer (errorDepositionNotification)
С помощью запроса
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.
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 |
<?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"/>
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. |
<?xml version="1.0" encoding="UTF-8"?> <errorDepositionNotificationResponse clientOrderId="12345" status="0" processedDT="2011-07-01T20:38:01.000Z"/>
- 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