API

  1. Home
  2. API
  3. Инициализация платежа
  4. Host-To-Host

Host-To-Host

При прямой передаче данных от магазина в 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 , на которой происходит уточнение недостающих параметров пользователем.