При прямой передаче данных от магазина в Platron магазин должен посылать данные на URL https://www.platron.ru/init_payment.php.
Ответ Platron представляет собой XML вида:
<?xml version="1.0" encoding="utf-8"?> <response> <pg_salt>ijoi894j4ik39lo9</pg_salt> <pg_status>ok</pg_status> <pg_payment_id>15826</pg_payment_id> <pg_redirect_url> https://www.platron.ru/payment_params.php?customer=ccaa41a4f425d124a23c3a53a3140bdc15826 </pg_redirect_url> <pg_redirect_url_type>need data</pg_redirect_url_type> <pg_sig>af8e41a4f425d124a23c3a53a3140bdc17ea0</pg_sig> </response>
Здесь:
| pg_payment_id | Уникальный идентификатор платежной транзакции в Platron. Служит ключом для всей дальнейшей работы с транзакцией. |
| pg_redirect_url | URL для перенаправления пользователя. Может быть как на сайте www.platron.ru , так и на сайте платежной системы |
| pg_redirect_url_type |
Тип страницы, на которую происходит перенаправление.
Возможные значения: need data – диалог с покупателем с целью уточнения параметров: платежной системы, номера телефона, обязательных для данной платежной системы параметров;payment system – страница сайта платежной системы либо страница с инструкциями оплаты через данную платежную систему. Страница с инструкциями может располагаться как на сайте platron.ru, так и на сайте магазина. |
| pg_salt | Случайная строка |
| pg_sig | Подпись |
В случае получения магазином ответа с pg_redirect_url_type=”need data”, магазин может не перенаправлять покупателя по полученному URL, а уточнить недостающие параметры у себя на сайте. В этом случае после уточнения параметров и повторного запроса на создание платежной транзакции будет создана новая транзакция.
Если для выполнения платежа с использованием определённой платёжной системы покупателю необходимо знать какие-либо дополнительные данные, ответ содержит эти данные в поле pg_ps_additional_data, как показано в примере:
<?xml version="1.0" encoding="UTF-8"?> <response> <pg_salt>c1058bea</pg_salt> <pg_status>ok</pg_status> <pg_payment_id>17837</pg_payment_id> <pg_redirect_url> https://www.platron.ru/ps/rapida/start_payment.php?no=939f392abc4e847ca340b237c79cd8a817837 </pg_redirect_url> <pg_redirect_url_type>payment system</pg_redirect_url_type> <pg_sig>13daa252681721b5f9ae176e57cc1d70</pg_sig> </response>
Поля, передаваемые при проведении платежа через конкретные платёжные системы, можно посмотреть в разделе «Справочник дополнительных параметров ПС».
В случае ошибки:
<?xml version="1.0" encoding="utf-8"?> <response> <pg_status>error</pg_status> <pg_error_code>101</pg_error_code> <pg_error_description>Empty merchant</pg_error_description> </response>
Здесь:
| pg_error_code | Код ошибки |
| pg_error_description | Описание ошибки |
В случае если запрос корректен, но магазином переданы не все параметры, необходимые для создания платежной транзакции (платежная система, телефон пользователя и параметры, необходимые для выбранной платежной системы), то pg_redirect_url представляет собой страницу на сайте www.platron.ru , на которой происходит уточнение недостающих параметров пользователем.