Идентификация платежей
Когда деньги приходят на номинальный счёт, банк не знает, какому бенефициару они принадлежат. Идентификация — это привязка входящего платежа к виртуальному счёту. Пока платёж не идентифицирован, деньги нельзя использовать в сделках.
Идентификация платежей
Метод identification_payment сопоставляет деньги входящего платежа с виртуальным счётом. В параметре owners вы указываете, на какой виртуальный счёт и какую сумму зачислить. Поля метода — в автогенерируемом описании Идентифицировать платёж.
Идентифицируйте платёж вовремя. На тестовом слое pre деньги автоматически возвращаются отправителю через 30 минут, на боевом prod на идентификацию даётся 96 часов. После автовозврата сопоставить платёж уже нельзя.
Иногда денег приходит больше, чем нужно. Тогда вместе с owners можно передать блок excess_refund и указать сумму, которую вернуть отправителю как излишек. Параметры owners и excess_refund необязательны по отдельности, но хотя бы один из них должен быть в запросе. В ответ на возврат излишка сервис создаёт отдельный платёж и возвращает его идентификатор и сумму.
Возможные ошибки:
| Код | Текст |
|---|---|
4411 | Virtual account not found |
4412 | Payment not found |
4413 | The discrepancy between the amounts |
4414 | The payment was previously identified |
4420 | Outgoing payment |
4438 | It is forbidden to work with a payment with the current type in the called method |
4450 | Virtual account mismatch with identification payment |
Идентификация возвращённого платежа по сделке
Бывает, что исходящий платёж по сделке возвращает банк-получатель — например, из-за неверных реквизитов. Метод identification_returned_payment_by_deal идентифицирует такие возвращённые деньги и привязывает их обратно к получателю в сделке. Поля метода — в описании Идентифицировать возврат.
Метод сработает, только если с момента оплаты до возврата платежа прошло не больше 31 календарного дня.
Возможные ошибки:
| Код | Текст |
|---|---|
4411 | Virtual account not found |
4412 | Payment not found |
4413 | The discrepancy between the amounts |
4414 | The payment was previously identified |
4417 | Not found deal |
4418 | This operation is impossible with the current status of the deal |
4438 | It is forbidden to work with a payment with the current type in the called method |
4439 | Multiple payments found |
4440 | Incoming payment |
4441 | The payment does not relate to the deal |