Platron — сервис приёма онлайн платежей и массовые выплаты — платежные системы для сайтов и услуг

Перед настройкой необходимо связаться с менеджером.

Послать данные в ОФД можно как из личного кабинета магазина, так и в автоматическом режиме путем вызова скрипта https://www.platron.ru/receipt.php.

Создавать данные для чека можно сразу после создания операции. Чек в ОФД и покупателю отправится только после успешного завершения операции. Для тестирования нужно связаться с менеджером. Параметры передаются одним из методов прямого запроса (см. Способы прямого взаимодействия между магазином и Platron). Максимальное время ожидания ответа – 30 секунд.

Если оплата в иностранной валюте или используется платежная система в которой настроена комиссия сверху платежа, то необходимо выписывать чек после получения запроса на result об успешном платеже. Данный запрос не работает для заявок на возврат и возвратов без платежа (moneyback) не привязанных к транзакции.

Список параметров запроса:

Параметр	Описание
pg_merchant_id	Идентификатор магазина
pg_operation_type	Тип операции (enum) payment — оплата refund – возврат по API moneyback – выплата
pg_payment_id *	Номер платежной транзакции (int)
pg_order_id *	Номер заказа магазина
pg_salt	Случайная строка
pg_sig	Подпись
pg_items	Массив позиций в чеке. См. таблицу ниже
pg_additional_payment_type	Дополнительная оплата. Возможные значения: 1. prepayment 2. credit Используется в случае необходимости произвести доплату за услуги или товар. Проводится вне текущей оплаты.
pg_additional_payment_amount	Сумма дополнительной оплаты. Параметр обязателен в случае, если передается параметр pg_additional_payment_type

* Требуется либо pg_payment_id, либо pg_order_id. В случае с pg_order_id, если он не уникальный, то чек будет создан к последнему заказу.

Поля pg_items:

pg_label*	Наименование товара (string) Максимальная длина составляет 128 символов
pg_price*	Цена товара с учетом всех скидок и наценок (float, 2 знака после запятой)
pg_quantity*	Количество (float)
pg_vat*	Ставка НДС (enum) 0 – ставка НДС 0% 10 – ставка НДС 10% 20 – ставка НДС 20% 110 – ставка НДС 10/110 120 – ставка НДС 20/120 none — не облагается НДС
pg_type	Тип услуги/товара.Возможные варианты: product — товар, за исключением подакцизного товара product_practical — подакцизный товар work — работа service — услуга gambling_bet — прием ставок при осуществлении деятельности по проведению азартных игр gambling_win — выплата денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр lottery_bet — прием денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей lottery_win — о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей rid — предоставление прав на использование результатов интеллектуальной деятельности или средств индивидуализации «ПРЕДОСТАВЛЕНИЕ РИД» или «РИД» payment — об авансе, задатке, предоплате, кредите, взносе в счет оплаты, пени, штрафе, вознаграждении бонусе и ином аналогичном предмете расчета commission — вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом composite — о предмете расчета, состоящем из предметов, каждому из которых может быть присвоено значение от «0» до «11» (0-11 — это вышеперечисленные) other — о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от «0» до «12» (0-12 — это вышеперечисленные) По умолчанию используется значение product
pg_payment_type	Способ расчета. Возможные варианты: pre_payment_full — полная предварительная оплата до момента передачи предмета расчета «ПРЕДОПЛАТА 100 %» pre_payment_part — частичная предварительная оплата до момента передачи предмета расчета — «ПРЕДОПЛАТА» full_payment — полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета — «ПОЛНЫЙ РАСЧЕТ» advance — аванс credit_part — частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит — «ЧАСТИЧНЫЙ РАСЧЕТ И КРЕДИТ» credit_pay — оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита) — «ОПЛАТА КРЕДИТА» credit — передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит — «ПЕРЕДАЧА В КРЕДИТ» По умолчанию используется значение full_payment
pg_agent_type	Тип платежного агента.Возможные варианты: commissionaire — осуществление расчета с покупателем (клиентом) пользователем, являющимся комиссионером
pg_agent_phone	Телефон поставщика (только цифры)
pg_agent_name	Имя поставщика
pg_agent_inn	ИНН поставщика (только цифры)

Если передано хотя бы одно из полей agent, необходимо запонение всех оставшихся полей.

* — обязательные к передаче поля.

Если у магазина нет необходимости передавать дополнительные параметры, никаких изменений вносить не нужно.

Пример GET запроса:

https://platron.ru/init_ofd.php?pg_merchant_id=82&pg_operation_type=payment&pg_payment_id=27052361&pg_salt=aaaaaaaaaa&pg_items[0][pg_label]=name&pg_items[0][pg_price]=100.00&pg_items[0][pg_quantity]=2.00&pg_items[0][pg_vat]=12&pg_items[0][pg_type]=product&pg_items[0][pg_payment_type]=pre_payment_full&pg_items[0]pg_items[0][pg_agent_type]=commissionaire&pg_items[0]pg_items[0][pg_agent_phone]=79991234567&pg_items[0][pg_agent_name]=company&pg_items[0][pg_agent_inn]=1254869631545&pg_salt=salt&pg_sig=8154527e508a8f3e2caf72f76f3d11cc

Пример XML запроса (передается POST’ом в параметре pg_xml):

<?xml version="1.0" encoding="utf-8"?>
<request>
	<pg_merchant_id>82</pg_merchant_id>
	<pg_operation_type>payment</pg_operation_type>
	<pg_payment_id>27053534</pg_payment_id>
	<pg_items>
		<pg_label>label</pg_label>
		<pg_price>10</pg_price>
		<pg_quantity>1</pg_quantity>
		<pg_vat>18</pg_vat>
		<pg_type>product</pg_type>
		<pg_payment_type>pre_payment_full</pg_payment_type>
		<pg_agent_type>commissionaire </pg_agent_type>
		<pg_agent_phone>79991234567</pg_agent_phone>
		<pg_agent_name>ООО ЭКСКЛЮЗИВ КОМПАНИ ЛИМИТЕД ИНТЕРНЕШНЛ</pg_agent_name>
		<pg_agent_inn>123456789012</pg_agent_inn>
	</pg_items>
	<pg_salt>salt</pg_salt>
	<pg_sig>c8de17ff9837e139a97t65ffcqw3fc6c</pg_sig>
</request>

Ответ на запрос представляет собой XML следующего вида в случае успешного выполнения запроса:

<?xml version="1.0" encoding="utf-8"?>
<response>
 	<pg_status>ok</pg_status>
 	<pg_receipt_id>135</pg_receipt_id>
 	<pg_salt>salt</pg_salt>
 	<pg_sig>60beff140b3c9c6dt87603522cc1c07f</pg_sig>
</response>

Здесь:

pg_receipt_id

Номер созданного чека

В случае ошибки:

<?xml version="1.0" encoding="utf-8"?>
<response>
	<pg_salt>9865</pg_salt>
	<pg_status>error</pg_status>
	<pg_error_code>100</pg_error_code>
	<pg_error_description>Incorrect signature</pg_error_description>
	<pg_sig>4df0f9d237952f56bd05c602d2873ed0</pg_sig>
</response>

Здесь:

pg_status	Результат обработки запроса
pg_error_code	Код ошибки
pg_error_description	Описание причины ошибки
pg_salt	Случайная строка
pg_sig	Подпись

API