Перед настройкой необходимо связаться с менеджером.
Послать данные в ОФД можно как из личного кабинета магазина, так и в автоматическом режиме путем вызова скрипта 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)
|
pg_type | Тип услуги/товара.Возможные варианты:
По умолчанию используется значение product |
pg_payment_type | Способ расчета.
Возможные варианты:
По умолчанию используется значение full_payment |
pg_agent_type | Тип платежного агента.Возможные варианты:
|
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 | Подпись |