7. Экспорт данных

В PayKeeper существует возможность выгружать данные о платежах в виде файла. Для этого используется следующий запрос:

  URI Назначение
7.1 /export/payments/ Экспорт истории платежей
7.2 /export/invoices/ Экспорт истории счетов

 

7.1 Запрос экспорта истории платежей /export/payments/

Для загрузки файла с историей платежей необходимо выполнить GET-запрос со следующими параметрами:

Тип Формат запроса
GET /export/payments/?type=xlsx&start=2014-04-17&end=2014-06-17&
status[]=success&status[]=canceled&status[]=failed&payment_system_id[]=9&
payment_system_id[]=1&from=0&limit=1000
  Параметр Назначение
1. type Желаемый тип файла для загрузки. Доступные значения: xlsx
2. start Дата начала периода в формате YYYY-MM-DD
3. end Дата конца периода в формате YYYY-MM-DD
4. payment_system_id[] Идентификатор платежной системы. Применяется для фильтрации по платежной системе. Обязательный параметр.
5. status[] Статус платежей. Применяется для фильтрации платежей по статусам. Может принимать значения: ‘pending’, ‘obtained’, ‘canceled’, ‘success’, ‘failed’, ‘stuck’, ‘refunded’, ‘refunding’, ‘partially_refunded’. Обязательный параметр.
6. from Пропускает первые N значений. Обязательный параметр.
7. limit Количество возвращаемых значений. Обязательный параметр.
Таблица 7.1.1. Параметры запроса

В результате данного запроса веб-сервер сгенерирует файл указанного типа, содержащий платежи, удовлетворяющие заданным условиям.

 

7.2 Запрос экспорта истории счетов /export/invoices/

Для загрузки файла с историей счетов необходимо выполнить GET-запрос со следующими параметрами:

Тип Формат запроса
  Параметр Назначение
GET /export/invoices/?start=2014-04-17&end=2014-06-17&
status[]=success&status[]=canceled&status[]=failed&from=0&limit=1000
2. start Дата начала периода в формате YYYY-MM-DD
3. end Дата конца периода в формате YYYY-MM-DD
5. status[] Статус счёта. Применяется для фильтрации счетов по статусам. Может принимать значения: ‘created’,’paid’,’expired’,’sent’. Обязательный параметр.
6. from Пропускает первые N значений. Обязательный параметр.
7. limit Количество возвращаемых значений. Обязательный параметр.
Таблица 7.1.1. Параметры запроса

В результате данного запроса веб-сервер сгенерирует файл в формате CSV, содержащий счета, удовлетворяющие заданным условиям.