API

  1. Home
  2. API
  3. Вспомогательные запросы
  4. Создание чека

Создание чека

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

Послать данные в ОФД можно как из личного кабинета магазина, так и в автоматическом режиме путем вызова скрипта 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%
  • 18 – ставка НДС 18%
  • 110 – ставка НДС 10/110
  • 118 – ставка НДС 18/118
Если поле отсутствует – не облагается НДС
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_vat>
		<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 Подпись