Возврат и проверка
Здесь два метода: досрочный возврат входящего платежа и предварительная проверка выплаты комплаенс-службой.
Возврат платежей
Метод refund_payment возвращает входящий платёж отправителю, не дожидаясь автоматического возврата. Он же возвращает входящий СБП-платёж, который уже был идентифицирован. Поля метода — в автогенерируемом описании Вернуть платёж.
Для обычного платежа достаточно передать его идентификатор. При возврате идентифицированного СБП-платежа типа incoming_sbp дополнительно заполните amount и virtual_accounts — с каких виртуальных счетов и сколько списать. Эти два поля заполняются только вместе и только для такого возврата. В назначении возврата по реквизитам не забудьте указать ссылку на НДС.
Возможные ошибки:
| Код | Текст |
|---|---|
4412 | Payment not found |
4414 | The payment was previously identified |
4422 | Payment refund error |
4451 | The purpose of the non-resident's payment contains incorrect or missing VO codes |
4558 | It is impossible to perform the operation due to the fact that restrictions are imposed on the beneficiary based on the writ of execution |
Проверка платежа на возможность проведения
Прежде чем отправить выплату на подпись, её можно проверить у комплаенс-службы. Метод compliance_check_payment заранее оценивает платежи типа payment_contract и ndfl на соответствие требованиям законодательства и подсказывает, пройдёт платёж или нет. Так вы не тратите время на выплату, которую всё равно отклонят. Поля метода — в описании Проверить платёж на возможность проведения.
В ответе поле approved показывает рекомендацию: true — платёж можно проводить, false — не пройдёт. В messages приходит детализация с уровнем ERROR или WARNING. Уровень ERROR означает, что после подписания платёж гарантированно откажут. Если не передать реквизиты номинального счёта плательщика, будет использован счёт по умолчанию.
Возможные ошибки:
| Код | Текст |
|---|---|
4436 | An error occurred while requesting compliance |