Developers

API and connection documentation

Реестры платежей

Задача.

В параметрах магазина есть возможность задать e-mail, на который каждый день будет высылаться реестр платежей по предыдущему дню. Реестр формируется в 0:10 по московскому времени. Заголовки письма содержат следующую информацию: X-Merchant-ID: Merchant ID, выданный магазину (пример: 14) X-Registry-Date: Дата, на которую составлен реестр, в формате ГГГГ-ММ-ДД (пример: 2009-12-02) Поле «От» письма содержит info@paybox.money Тема письма: PayBox report for merchant # [ГГГГ-ММ-ДД] Реестр высылается в теле письма или во вложении, в зависимости от настроек в личном кабинете, представляет собой набор данных с разделителями «табуляция». Первая строка содержит названия полей. Если поле не определено, две табуляции следуют подряд. Реестр высылается, даже если за прошедший день не было ни одной транзакции. В этом случае в теле письма присутствует только строка заголовка.

Структура реестра операций
Код поля Название поля Описание
order_id Номер заказа Номер, переданный магазином как номер заказа
pg_payment_id Номер операции BILLNUMBER, номер платежа, сформированный PayBox.
op_date Дата операции
op_time Время операции
type Тип операции Трехбуквенный код операции: "pay" – операция оплаты счета,"ref" – возврат средств(через ту же платежную систему, через которую прошла транзакция) “rev” – reversal “mb” – возврат средств(через платежную систему отличающуюся от платежной системы транзакции) “rev_mb” – отмена возврата
payment_system наименование платёжной системы Наименование платёжной системы (из Справочника платёжных систем и групп).
payment_type Тип платежа (direct или transit) Тип контракта с Платёжной системой: direct – прямой контракт между магазином и ПС, transit – контракт между PayBox и ПС
bill_amount Сумма выставленного счета Сумма счета, первоначально выставленного мерчантом, в валюте, в которой он первоначально выставлен
bill_cur_symbol Валюта, в которой выставлен счет Код валюты в международном стандарте (KZT, EUR, USD)
amount Сумма Сумма, уплаченная плательщиком в пользу магазина
pg_commission Комиссионное вознагрождение Агента Комиссионное вознаграждение PayBox за операцию.
ps_commission Комиссионное вознаграждение Платёжной системы Комиссионное вознаграждение платёжной системы за операцию (отсутствует, если type=”transit”)
to_pay К перечислению Разница между суммой операции и комиссионным вознаграждением.
currency Валюта Код валюты в международном стандарте (KZT, EUR, USD)

В целях обеспечения безопасности магазину рекомендуется проверять заголовки письма, чтобы убедиться в подлинности полученного реестра.


Пример реестра:
order_id 123 127 131 135 139 143 147 151 155 159
pg_payment_id 15776132 15776132 15777640 15778038 15826930 15827330 15827330 15827330 15844840

Need a consultation?

Send an enquiry and our managers will contact you in 15 minutes.