Операция get_documents_history_ext
Операция получения истории платежей.
Для этой операции доступен только формат ответа json.
Параметры запроса
| Параметр | Значение |
|---|---|
| operation | get_documents_history_ext |
| login | <Имя пользователя> |
| token | <TOKEN>. Получен при вызове get_token. |
| encrypted_password | Зашифрованный пароль. Получен в результате RSA шифрования пароля пользователя при помощи публичной экспоненты и модуля, полученных при вызове операции get_token. |
| period_from | Начальная дата периода выборки документов (по-умолчанию — 7 дней назад). Формат: ДД.ММ.ГГГГ |
| period_to | Конечная дата периода выборки документов (по-умолчанию — сегодня). Формат: ДД.ММ.ГГГГ |
| document_state | Статус документа. Может принимать одно из следующих значений:
|
| limit | Максимальное количество возвращаемых записей на страницу (от 50 до 1000). По-умолчанию – 100. В случае 0 – записи не возвращаются. |
| page | Номер страницы (от 1 и больше). Если page < 1 или не передан, то будет установлен в 1. |
| account | Номер вашего счета (необязательно). |
| external_account | Поиск по корреспонденту (необязательно). |
Смотрите также
- import_batch_advanced — Загрузка массового платежа (батча) в систему с возможностью выбора способа подтверждения.
- get_batch_info — Операция получения подробной информации по загруженному документу массового платежа (по батчу).
- documents_search — Поиск документов по номеру платежа из вашей системы.
Значения ответа
| Value | Description |
|---|---|
| data.pages | Сводка о количестве записей и страницах. |
| pages.itemCount | Общее количество записей. |
| pages.pageCount | Общее количество страниц. |
| pages.pageSize | Выбранный размер страницы. |
| pages.currentPage | Номер текущей страницы (начиная с 1). |
| pages.currentPageCount | Число записей на текущей странице. |
| data.history | Найденные записи. |
| history[].number | Номер документа. |
| history[].id | ID документа. |
| history[].batch | Информация из массового платежа, если платеж был отправлен массовым платежом. |
| batch.id | ID массового платежа. |
| batch.number | Внутренний номер платежа в вашей системе. |
| batch.type | Тип массового платежа. |
| batch.timestamp | Дата массового платежа. |
| history[].timestamp | Дата создания документа. |
| history[].state | Статус платежа:
|
| history[].stateLocalized | Локализованное отображение статуса платежа. |
| history[].channel | Платежная система. |
| history[].correspondent | Корреспондент. |
| history[].comment | Причина отклонения платежа. |
| history[].account | Ваш номер счета списания или пополнения. |
| history[].amount | Сумма платежа. |
| history[].currency | Валюта платежа (и комиссии). |
| history[].tax | Комиссия. |
| history[].destAmount | Сумма назначения (в случае отличия валюты от валюты платежа. |
| history[].destCurrency | Валюта назначения. |
| history[].description | Назначение платежа. |
| history[].outgoing | Направление: исходящий или входящий платеж. |
| history[].selfExchange | Обмен между своими счетами. |
| history[].txId | ID крипто транзакции. |
Примеры ответов
JSON (рекомендуемый, установите x-response-format=json)
{
"code": 0,
"message": "",
"data": {
"pages": {
"itemCount": 7,
"pageCount": 1,
"pageSize": 50,
"currentPage": 1,
"currentPageCount": 7
},
"history": [
{
"number": 94706096,
"id": 94706089,
"batch": null,
"timestamp": 1525447957,
"state": "executed",
"stateLocalized": "Исполнен",
"channel": "Capitalist",
"correspondent": "U0366438",
"comment": "Fri May 04 18:32:37 MSK 2018",
"account": "U0100192",
"amount": 123,
"tax": null,
"currency": "USD",
"destAmount": null,
"destCurrency": null,
"description": "Test",
"outgoing": false,
"selfExchange": false,
"txId": null
},
{
"number": 94706036,
"id": 94706034,
"batch": null,
"timestamp": 1525447328,
"state": "executed",
"stateLocalized": "Исполнен",
"channel": "Банковский счет",
"correspondent": "Wires",
"comment": "",
"account": "U0100192",
"amount": 2300,
"tax": null,
"currency": "USD",
"destAmount": null,
"destCurrency": null,
"description": "Popolnenie!",
"outgoing": false,
"selfExchange": false,
"txId": null
},
{
"number": 94706028,
"id": 94706023,
"batch": null,
"timestamp": 1525445511,
"state": "inprocess",
"stateLocalized": "В обработке",
"channel": "Capitalist",
"correspondent": "R0366510",
"comment": null,
"account": "U0100020",
"amount": 43,
"tax": null,
"currency": "USD",
"destAmount": "2672.26000000",
"destCurrency": "RUR",
"description": "Test (Конвертация валюты 43.00 USD в 2672.26 RUR)",
"outgoing": true,
"selfExchange": false,
"txId": null
},
{
"number": 94706015,
"id": 94706012,
"batch": null,
"timestamp": 1525444195,
"state": "inprocess",
"stateLocalized": "В обработке",
"channel": "Банковская карта РФ",
"correspondent": "5106214000267756",
"comment": null,
"account": "U0100652",
"amount": 100,
"tax": 1,
"currency": "USD",
"destAmount": "6214.57000000",
"destCurrency": "RUR",
"description": "Test",
"outgoing": true,
"selfExchange": false,
"txId": null
},
{
"number": 94706004,
"id": 94706001,
"batch": null,
"timestamp": 1525443418,
"state": "executed",
"stateLocalized": "Исполнен",
"channel": "Capitalist",
"correspondent": "R0100671",
"comment": null,
"account": "U0100020",
"amount": 5000,
"tax": null,
"currency": "USD",
"destAmount": "310728.54000000",
"destCurrency": "RUR",
"description": "Конвертация валюты 5000.00 USD в 310728.54 RUR",
"outgoing": true,
"selfExchange": true,
"txId": null
},
{
"number": 94705997,
"id": 94705990,
"batch": {
"id": "475054ff-6b34-44fd-a680-57ccf99744ce",
"number": "9999",
"type": "WM",
"timestamp": 1525443058
},
"timestamp": 1525443092,
"state": "declined",
"stateLocalized": "Отклонен",
"channel": "WebMoney",
"correspondent": "Z123456789012",
"comment": "Ne nado!",
"account": "U0100692",
"amount": 10,
"tax": 0,
"currency": "USD",
"destAmount": null,
"destCurrency": null,
"description": "Payout",
"outgoing": true,
"selfExchange": false,
"txId": null
},
{
"number": 94705981,
"id": 94705979,
"batch": {
"id": "475054ff-6b34-44fd-a680-57ccf99744ce",
"number": "9999",
"type": "WM",
"timestamp": 1525443058
},
"timestamp": 1525443092,
"state": "inprocess",
"stateLocalized": "В обработке",
"channel": "WebMoney",
"correspondent": "Z123456789012",
"comment": null,
"account": "U0100692",
"amount": 10,
"tax": 0,
"currency": "USD",
"destAmount": null,
"destCurrency": null,
"description": "Payout",
"outgoing": true,
"selfExchange": false,
"txId": null
}
]
}
}