Разработчикам
Документация по подключению и API
Реестры платежей
Задача.
В параметрах магазина есть возможность задать 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 |