Old versions of the API
Help
Sign up for YooMoney
Declined payouts
Something might go wrong during a payout. For example, the payout limit may be exceeded, YooMoney may suspect a fraud attempt, or there may not be enough money on the payout balance. In this case, the payout will be canceled and its status will be updated to canceled.
In order for you to have a better understanding of what happened and what you need to do with it, YooMoney will provide a comment to the canceled payout (cancellation_details) in the payout object . It will include information about the initiator and reason for canceling the payout. You can use this information to analyze and solve problems, display messages to the customer, or for any other purposes.
Example of a payout object with the canceled status
JSON
{
    "id": "po-285ec15d-0003-5000-a000-08d1bec7dade",
    "amount": {
        "value": "5.00",
        "currency": "RUB"
    },
    "status": "canceled",
    "payout_destination": {
        "type": "bank_card",
        "card": {
            "first6": "444444",
            "last4": "4448",
            "card_type": "Visa",
            "issuer_country": "PL",
            "issuer_name": "Krakowski Bank Spoldzielczy"
        }
    },
    "description": "Payout for order No. 37",
    "created_at": "2021-06-16T13:04:55.633Z",
    "metadata": {
        "order_id": "37"
    },
    "test": false,
    "cancellation_details": {
        "party": "yoo_money",
        "reason": "general_decline"
    }
}
Initiators of the cancellation of the payout
The initiator of the cancellation is returned in the party parameter of the cancellation_details object.
ValueDescription
yoo_moneyYooMoney
payout_networkAny participants of the refund process except you and YooMoney (for example, the issuer of the bank card)
Reasons why the payout was canceled
The reason for the cancellation is returned in the reason parameter of the cancellation_details object.
ValueDescription
fraud_suspectedThe payout was blocked due to suspected fraud. Contact the party that cancelled the payout to learn more details, or select another method of receiving the payout or other means of payment (for example, another bank card).
general_declineNo specific reason provided. Contact the party that cancelled the payout to learn more details.
insufficient_fundsThere's not enough money on the balance to make a payout. Add money to the balance and make a request again detailing a new idempotence key.
issuer_unavailableThe acquirer is unavailable. Select another method of receiving the payout or other means of payment (for example, another bank card), or make a request again detailing a new idempotence key.
one_time_limit_exceeded
The single deposit limit is exceeded. Decrease the payout amount, split the amount and make several payouts, select another method of receiving the payout or other means of payment (for example, another bank card).
For payouts to YooMoney wallets, the maximum payout amount depends on the limit for balance: after the payout, the wallet balance can’t exceed a certain amount that depends on the user status. If the payout wasn’t processed due to the limit for balance, the recipient must change their status or spend the excessive amount on the balance.
periodic_limit_exceededThe limit on payouts over the period (day, month) is exceeded. Select another method of receiving the payout or other means of payment (for example, another bank card). You can modify the limits if necessary. To do this, please contact your YooMoney manager.
recipient_check_failedFor payouts with recipient verification only. The payout recipient verification has failed: the payout recipient's name didn't match the name of the account holder where the money should be transferred. What to do in this case
recipient_not_foundFor payouts via FPS: the recipient hasn't found, which means that there's no account linked to the specified phone number in the selected bank or payment service. Make a request again detailing new data and a new idempotence key, or select another method of receiving the payout.
rejected_by_payeeIssuer declined the payout for unspecified reasons. The user must contact the issuer to learn more details or select another method of receiving the payout or other means of payment (for example, another bank card).
See also
HTTP response codes
Legal information
Terms and Conditions of the YooMoney ServiceElectronic Document Flow Agreement
+7 (495) 974-35-86
Ask a questionHelp
© 2025, "YooMoney", NBCO LLC