Разработчикам

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

Задача.

В параметрах магазина есть возможность задать 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