Неуспешные выплаты — Выплаты по API ЮKassa

Неуспешные выплаты

В процессе выплаты что-то может пойти не так. Например, может быть превышен лимит выплаты, ЮKassa может заподозрить попытку мошенничества, на балансе выплат может не хватить денег. В этом случае выплата будет отменена и перейдет в статус canceled.

Чтобы вы могли лучше понимать, что произошло и что с этим делать, ЮKassa пришлет в объекте выплаты комментарий к отмене выплаты (cancellation_details). В нём будут указаны инициатор и причина отмены выплаты. Вы можете использовать эти данные для анализа и решения проблем, вывода сообщений пользователю и любых других целей.

Пример объекта выплаты в статусе canceled

JSON
{
    "id": "po-285ec15d-0003-5000-a000-08d1bec7dade",
    "amount": {
        "value": "100.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": "Выплата по заказу №37",
    "created_at": "2021-06-16T13:04:55.633Z",
    "metadata": {
        "order_id": "37"
    },
    "test": false,
    "cancellation_details": {
        "party": "yoo_money",
        "reason": "general_decline"
    }
}

Инициаторы отмены выплаты

Инициатор отмены возвращается в параметре party объекта cancellation_details.

Значение	Описание
yoo_money	ЮKassa
payout_network	Любые участники процесса выплаты, кроме ЮKassa и вас (например, эмитент банковской карты)

Причины отмены выплаты

Причина отмены возвращается в параметре reason объекта cancellation_details.

Значение	Описание
fraud_suspected	Выплата заблокирована из-за подозрения в мошенничестве. Следует обратиться к инициатору отмены выплаты за уточнением подробностей или выбрать другой способ получения выплаты или другое платежное средство (например, другую банковскую карту).
general_decline	Причина не детализирована. Следует обратиться к инициатору отмены выплаты за уточнением подробностей.
insufficient_funds	На балансе выплат не хватает денег для проведения выплаты. Пополните баланс и повторите запрос с новым ключом идемпотентности.
issuer_unavailable	Эквайер недоступен. Следует выбрать другой способ получения выплаты или другое платежное средство (например, другую банковскую карту) или повторить запрос позже с новым ключом идемпотентности.
one_time_limit_exceeded	Превышен лимит на разовое зачисление. Можно уменьшить размер выплаты, разбить сумму и сделать несколько выплат, выбрать другой способ получения выплат или другое платежное средство (например, другую банковскую карту). Для выплат на кошельки ЮMoney максимальный размер выплаты зависит от лимита на баланс: после выплаты остаток в кошельке не должен превышать определенную сумму, размер которой зависит от статуса кошелька. Если выплата не проходит из-за лимита на баланс, получателю следует изменить статус кошелька или потратить сумму, на которую превышается остаток.
periodic_limit_exceeded	Превышен лимит выплат за период времени (сутки, месяц). Следует выбрать другой способ получения выплаты или другое платежное средство (например, другую банковскую карту). При необходимости вы можете изменить лимиты. Для этого обратитесь к вашему менеджеру ЮKassa.
recipient_check_failed	Только для выплат с проверкой получателя. Получатель выплаты не прошел проверку: имя получателя не совпало с именем владельца счета, на который необходимо перевести деньги. Что делать в этом случае
recipient_not_found	Для выплат через СБП: получатель не найден — в выбранном банке или платежном сервисе не найден счет, к которому привязан указанный номер телефона. Следует повторить запрос с новыми данными и новым ключом идемпотентности или выбрать другой способ получения выплаты.
rejected_by_payee	Эмитент отклонил выплату по неизвестным причинам. Пользователю следует обратиться к эмитенту за уточнением подробностей или выбрать другой способ получения выплаты или другое платежное средство (например, другую банковскую карту).

Что почитать еще

Коды ответа (состояния) HTTP Тестирование выплат