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.Value | Description |
---|---|
yoo_money | YooMoney |
payout_network | Any 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.Value | Description |
---|---|
fraud_suspected | The 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_decline | No specific reason provided. Contact the party that cancelled the payout to learn more details. |
insufficient_funds | There'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_unavailable | The 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_exceeded | The 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_failed | For 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_found | For 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_payee | Issuer 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