Получение информации о Списании

См также методы API v3, которые позволяют получить список Списаний текущего Реселлера или любого из его нижестоящих Реселлеров по указанному ID Реселлера (см. Списания Реселлеров).

Метод Get Charge Info by ID в API v1 позволяет получить список Списаний для данного Реселлера.

Метод {base_url}/api/vendor/v1/charges/{charge_id} устарел. Рекомендуется использовать:

GET {base_url}/api/reseller/v1/charges/{charge_id}?api_token={api_token}

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
api_token	query	string	Обязательный	API токен Сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике). Текущий Реселлер определяется по данному токену
charge_id	path	integer	Обязательный	ID Списания, о котором запрашивается информация

Модель ответа

Название	Тип данных	Описание
id	integer	ID Cписания
subscription_id	integer	ID Подписки
subscription_resource_id	integer	ID Ресурса в Подписке
subscription_resource_name	string	Имя Ресурса в Подписке
plan_resource_id	integer	ID ресурса в Тарифном плане
resource_id	integer	ID Ресурса в Шаблоне услуги
quantity	integer	Количество заказанных единиц Услуги или Ресурса
operate_from	date	Дата начала периода, оплаченного Списанием
operate_to	date	Дата окончания периода, оплаченного Списанием
duration	float	Период Списания, измеряемый в месяцах. Например, период 1 день = 0.033, 2 года = 24
description	string	Подробная информация о Списании
unit_price	float	Стоимость одной единицы Услуги или Ресурса
amount	float	Общая сумма Списания
status	string	Текущий статус Списания (список статусов см. в Атрибуты списаний)
type	string	Тип Списания (см. также Атрибуты списаний) Charge::Setup — Списание за установку Подписки. Charge::Recurring — Списание за абонентскую плату Подписки. Charge::RecurringResource — Списание за абонентскую плату ресурса Подписки. Charge::Renewal — Списание за продление Подписки. Charge::RenewalResource — Списание за продление Ресурса. Charge::ExternalResource — Списание за использование внешнего Ресурса. Charge::SetupResource — Списание за установку Ресурсов Подписки. Charge::Transfer — списание за перенос Домена.
order_id	integer	ID Заказа, по которому произведено Cписание
close_date	date	Дата, когда Cписание должно быть закрыто
original_amount	string	Размер Списания в валюте Тарифного плана
original_amount_currency	string	Код валюты Тарифного плана
currency_rate	string	Курс, по которому сформировано Списание
currency_unit	integer	Номинал валюты, который использовался при расчете величины Cписания
created_at	date	Дата и время создания Списания
updated_at	date	Дата и время последнего изменения Списания

Пример запроса

GET https://test.activeplatform.com/api/reseller/v1/charges/77530?api_token=Y5fwetest3gJXZH5uHCw

Пример ответа

{
    "id": 77530,
    "subscription_id": 3006017,
    "subscription_resource_id": null,
    "subscription_resource_name": null,
    "plan_resource_id": null,
    "resource_id": null,
    "quantity": 1,
    "operate_from": "2020-07-27",
    "operate_to": "2020-08-26",
    "duration": 1,
    "description": "Purchasing Plan (setup fee) #3006017 \"auto provisioning\"",
    "unit_price": "10.0",
    "amount": "91.23",
    "status": "deleted",
    "type": "Charge::Setup",
    "order_id": 8464,
    "close_date": "2020-07-31",
    "original_amount": "11.4",
    "original_amount_currency": "RUB",
    "currency_rate": "8.0",
    "currency_unit": 1,
    "created_at": "2020-07-27T05:01:39.735707+0300",
    "updated_at": "2020-07-27T06:11:27.832344+0300"
}