Возвраты выплат
Даже после успешного зачисления денег на банковский счет получателя возможен возврат. Это происходит, например, если в реквизитах была ошибка или счет получателя перестал действовать.
В такой ситуации деньги возвращает банк, обслуживающий получателя.
Вы не можете сами отменить или вернуть успешную выплату. Единственный способ — попросить получателя перевести деньги обратно вам.
Как узнать, что выплата вернулась
Есть три способа отследить возврат.
Через вебхук
Дождитесь входящего вебхука checkout_refunded. В его теле будут данные выплаты, которая вернулась. Идентификатор исходной выплаты находится в поле id внутри массива payouts.
Через запрос статуса сессии
Если вы не используете вебхуки или предпочитаете активный опрос, отправьте запрос transaction/state. В ответе придет информация о статусе платежной сессии. При наличии возврата в ответе также будут данные о возврате.
Через реестр выплат
Информация о возврате выплаты приходит в реестре выплат. На следующий день после того, как выплата вернется, в реестре появится строка с ее описанием: в поле typeOfPayment будет Refund.