После вызова метода оплаты сделки платежи за товар и за доставку инициируют оплату и зачастую могут ожидать подтверждения плательщиком.
Для того чтобы узнать что платеж требует подтверждения вызываем метод получение данных по сделки и в ответе смотрим на объекты платежей data.productPayment и data.handlerPayment. Статус самого платежа status остается в "NEW", но статус waitingFor должен быть в статусе "CONFIRMATION", это означает что этот платеж нужно подтверждать. В поле details.confirmation, будет храниться объект, который нужен для подтверждения платежа.
...
Процедура подтверждения платежа заключаеться в том, что плательщику приходит смс с кодом подтверждения от банка-эмитента, который нужно передать в метод подтверждения платежа системы Escrow Box. Процесс передачи этого кода от плательщика до системы Escrow Box лежит на реализации клиента-интегратора. Как пример, это просто обычная форма с одним полем и кнопкой "Отправить" на клиентской части сервиса клиента-интегратора, которая вызовет метод сервиса клиента-интегратора, а он в свою очередь вызовет метод подтверждения платежа системы Escrow Box c параметром code, в этом случае details.confirmation.redirectUrl являеться URL-ом на который нужно отпрвить подтверждение.
...
Процедура подтверждения платежа заключаеться в том, что плательщику приходит смс с кодом подтверждения от банка-эмитента, который нужно ввести на странице подтверждения(ACS) банка-эмитента. Процес вызова этой страницы лежит на реализации клиента-интегратора. На клиентской части сервиса клиента-интегратора нужно реализовать форму с методом отправки POST запроса при submit на action details.confirmation.url c двома полями: "TermUrl"(в значение указать URL системы-интегратора на который прийдет postback от банка с данными для подтверждения платежа) и "PaReq"(в значение указать значение из details.confirmation.form.PaReq). После вызова данной формы, плательщика редиректит на страницу подтверждения платежа банка-эмитента, там он подтверждает платеж и после успешного подтверждения банк отправляет postback на URL, который был указан в форме. Есть ситуации, когда банк не показывает страницу подтверждения платежа, а сразу отправляет postback, смотрите ниже информацию по quasi-3DS. В ответ прийдет объект с параметром "PaRes" и от некоторых банков может быть параметр "MD", эти параметры нужно отправить в метод подтверждения платежа системы Escrow Box на URL details.confirmation.redirectUrl.
...
Подтвержденным платеж будет считаться, когда его статус смениться с "NEW" на "PAID", а не когда вызоветься метод подтверждения платежа. В связи с этим, после вызова метода подтверждения платежа при любом подтверждении, нужно трекать состояния сделки и смотреть на состояние платежей.
...