API

  1. Home
  2. API
  3. Вспомогательные запросы
  4. Получение реестра операций

Получение реестра операций

Для сверки проведенных операций вы можете воспользоваться скриптом 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 Доставка