YooMoney API
Old versions of the API
Help
Sign up for YooMoney
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.
 
Request format
Request parameters
ParameterTypeDescription
clientOrderIdClientTransactionNumberID of the operation received from your system in the request for funds deposit (makeDeposition).
requestDTxs:dateTimeThe date and time the operation request was executed on the YooMoney side, according to their system.
dstAccountYMAccountIdentifier of the transfer recipient.
amountCurrencyAmountThe transfer amount. For example: 12.34.
currencyCurrencyCodeCurrency code of the transfer. Possible value — 643 (Russian ruble).
errorxs:stringOperation 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
ParameterTypeDescription
statusxs:intResult 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.
clientOrderIdClientTransactionNumberA copy of the clientOrderId request parameter.
processedDTxs:dateTimeTime 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
  1. 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).
  2. 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.
  3. 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.
  4. The notification contains the operation ID (clientOrderId) received from you in the request for funds deposit (makeDeposition).
See also
Request status codes Error codes Data types