Для сверки проведенных операций вы можете воспользоваться скриптом https://www.platron.ru/get_registry.php
Ниже приведены параметры, которые должны быть переданы в запросе:
Название | Описание |
pg_merchant_id | Идентификатор магазина |
pg_date | Дата, за которую вы получите операции. Формат yyyy-mm-dd |
pg_salt | Случайная строка |
pg_sig | Подпись |
Вы не можете совершить еще один запрос, пока не отработал первый запрос. В этом случае вы получите ошибку.
Пример запроса:
https://www.platron.ru/get_registry.php?pg_merchant_id=1234&pg_date=2016-11-15&pg_salt=f387f3h3&pg_sig=bfc5f9d2379d287052f56bd05c60296e
В случае успеха будет возвращен такой ответ:
<?xml version="1.0" encoding="utf-8"?> <response> <pg_status>ok</pg_status> <operation> <type>pay</type> <payment_type>direct</payment_type> <pg_payment_id>28236796</pg_payment_id> <order_id>9789932</order_id> <description>hotel reservetion description</description> <merchant_id>82</merchant_id> <payment_system>GDSHOTELWITHRUSSIANSTANDARD</payment_system> <bill_amount>5138.0000</bill_amount> <amount>0.0000</amount> <currency>RUB</currency> <bill_cur_symbol>RUB</bill_cur_symbol> <op_date>15.11.2016</op_date> <op_time>10:26:45</op_time> <to_pay>0.0000</to_pay> <pg_commission>0.0000</pg_commission> <ps_commission>0.0000</ps_commission> </operation> <pg_salt>f387f3h3</pg_salt> <pg_sig>cac84530938b7e51b2d272e1d0212457</pg_sig> </response>
В случае ошибки ответ будет выглядеть следующим образом:
<?xml version="1.0" encoding="utf-8"?> <response> <pg_status>error</pg_status> <pg_error_code>200</pg_error_code> <pg_description>Отсутствует необходимый параметр</pg_description> </response>
В параметрах магазина есть возможность задать e-mail, на который каждый день будет высылаться реестр платежей по предыдущему дню. Реестр формируется в 0:10 по московскому времени.
Заголовки письма содержат следующую информацию:
• X-Merchant-ID: Merchant ID, выданный магазину (пример: 14)
• X-Registry-Date: Дата, на которую составлен реестр, в формате ГГГГ-ММ-ДД (пример: 2009-12-02)
• Поле «От» письма содержит info@platron.ru
• Тема письма: Platron report for merchant #
Реестр высылается в теле письма или во вложении, в зависимости от настроек в личном кабинете, представляет собой набор данных с разделителями «табуляция». Первая строка содержит названия полей. Если поле не определено, две табуляции следуют подряд.
Реестр высылается, даже если за прошедший день не было ни одной транзакции. В этом случае в теле письма присутствует только строка заголовка.
Код поля | Название поля | Описание |
order_id | Номер заказа | Номер, переданный магазином как номер заказа |
pg_payment_id | Номер операции | BILLNUMBER, номер платежа, сформированный Platronом. |
op_date | Дата операции | |
op_time | Время операции | |
Type | Тип операции | Трехбуквенный код операции: “pay” – операция оплаты счета, “ref” – возврат средств(через ту же платежную систему, через которую прошла транзакция) “rev” – reversal “mb” – возврат средств(через платежную систему отличающуюся от платежной системы транзакции) “rev_mb” – отмена возврата “par” – возврат при частичном клиринге |
payment_system | Наименование платёжной системы | Наименование платёжной системы (из Справочника платёжных систем и групп). |
payment_type | Тип платежа (direct или transit) | Тип контракта с Платёжной системой: direct – прямой контракт между магазином и ПС, transit – контракт между Platron и ПС |
bill_amount | Сумма выставленного счета | Сумма счета, первоначально выставленного мерчантом, в валюте, в которой он первоначально выставлен |
bill_cur_symbol | Валюта, в которой выставлен счет | Код валюты в международном стандарте (RUB, EUR, USD) |
amount | Сумма | Сумма, уплаченная плательщиком в пользу магазина |
pg_commission | Комиссионное вознаграждение Агента | Комиссионное вознаграждение Platron за операцию. |
ps_commission | Комиссионное вознаграждение Платёжной системы | Комиссионное вознаграждение платёжной системы за операцию (отсутствует, если type=”transit”) |
to_pay | К перечислению | Разница между суммой операции и комиссионным вознаграждением. |
currency | Валюта | Код валюты в международном стандарте (RUB, EUR, USD) |
description | Описание | Описание заказа, переданного при запросе на создание транзакции |
В целях обеспечения безопасности магазину рекомендуется проверять заголовки письма, чтобы убедиться в подлинности полученного реестра.
Пример реестра:
order_id | pg_payment_id | op_date | op_time | type | payment_system | payment_type | bill_amount | bill_cur_symbol | amount | pg_commission | ps_commission | to_pay | currency | description |
289 | 79004 | 02.12.09 | 13:32:56 | pay | WEBMONEYE | direct | 0.13 | EUR | 0.1300 | 0.0003 | 0.0000 | 0.13 | EUR | Заказ №4077 |
291 | 79212 | 02.12.09 | 19:39:41 | pay | TEST | transit | 10 | RUB | 10.0000 | 0.0000 | 10.00 | RUB | Оплата за трансфер | |
293 | 79216 | 02.12.09 | 19:42:10 | pay | TEST | transit | 0.30 | USD | 10.0000 | 0.0000 | 10.00 | RUB | Комиссия агента | |
76392 | 78930 | 02.12.09 | 00:08:22 | pay | RAIFFEISEN | direct | 35.87 | USD | 1076.1400 | 2.5951 | 35.5100 | 1073.54 | RUB | Доплата за товар Б75540 |
76394 | 78932 | 02.12.09 | 00:15:02 | pay | RAIFFEISEN | direct | 994.26 | RUB | 994.2600 | 2.3976 | 32.8100 | 991.86 | RUB | Доставка |