Get the Reseller's Charge information by ID

The Get the Reseller's Charge by ID method returns end-customer Charge details of the downstream Reseller of the current Reseller.

Access to the current Reseller and downstream Resellers is determined by the Manager's token in the API request.

GET {base_url}/api/v3/resellers/{reseller_id}/reseller_charges/{charge_id}

Arguments

Name	Parameter Type	Data type	Required/ Optional	Description
X-Api-Token	header	string	Required	API token of the Manager that performs the operation (see Viewing and updating manager's information)
Content-Type	header	string	Required	Indicates the media type (text/html or text/JSON) of the request that is sent to the server by the client (browser)
Accept	header	string	Required	Information about data types that the client (browser) supports
reseller_id	path	integer	Required	ID of the current Reseller or any of its downstream Resellers (see Viewing and updating reseller general information)
charge_id	path	string	Required	ID of the Charge
include	query	string	Optional	Returns additional information about objects related to Charges. The parameter can be a comma-separated list if information about several objects is required. The following objects (possible values) are supported: Reseller Account Subscription Plan Discount

Response model

Name

Data type

Description

data array Response data

id

integer

ID of the Charge

type string Data type

attributes object Information about the Charge

created_at date Date and time of the Charge creation

updated_at date Date and time when the Charge was updated

charge_id

integer

ID of the end-customer Charge closing of which caused generation of the Reseller Charge
ID of the Reseller Charge of the downstream Reseller creation of which caused generation of the Reseller Charge

subscription_id integer ID of the customer's Subscription

unit_price float The unit price of the Service or Resource in the Plan currency

amount float Total amount of the Charge (Discount included) in the Reseller currency

net_cost

float

The net cost of the Charge in the Plan currency for the selected Reseller, for delegated Plans only:

net_cost = license_fee * duration * quantity

where license_fee is the License fee for a Resource or period of the Plan specified in the License (not stored in the Reseller Charge, see Creating a License)

subscription_resource_id integer ID of the Resource in the customer's Subscription

subscription_resource_name string Name of the Resource in the customer's Subscription

plan_resource_id integer Name of the Resource in the customer's Plan

resource_id integer ID of the Resource

quantity integer The number of ordered Services or Resources

operate_from

date

The start date of the period paid by the Charge

operate_to date The finish date of the period paid by the Charge

duration float Period of the Charge (in months). For example, 1 day = 0.033, 2 years = 24

description string Charge details description

type

string

Type of the Charge (see also Charges attributes)

Charge::Setup — a non-recurring Charge for Service setup
Charge::Recurring — a monthly Charge for Service usage
Charge::Recurring Resource — a monthly Charge for Resource usage
Charge::Renewal — a non-recurring Charge for Service renewal
Charge::Renewal Resource — a non-recurring Charge for Resource renewal
Charge::External Resource — an accumulative Charge based on the consumed resources records
Charge::Setup Resource — a non-recurring Charge for Resource setup
Charge::Transfer — a non-recurring Charge for Subscription transfer

order_id integer ID of the Order

additional_params

array of objects

Additional parameters of the Charge for Services based on the following plugins:

Office365:

Name	Data type	Description
tenant_name	string	Tenant name (login) in Microsoft Partner Center
tenant_id	string	Tenant ID in Microsoft Partner Center
order_id	string	Order ID on the Microsoft side
subscription_id	string	Subscription ID on the Microsoft side
offer_id	string	Plan SKU or Addon SKU in Microsoft Partner Center

Vendor Service Plugin (VSP):

Name	Data type	Description
external_id	string	Application. External ID
plan_sku	string	Plan SKU
subscription_attributes	object	Subscription attributes created in Vendor Portal (the password attribute excluded)
resource_key	string	Application Resource Key

In other cases, returns the empty array

discount float The amount of the Discount for the Charge in the Reseller currency

original_amount

string

Charge total amount in the Plan currency

original_amount_currency string Currency code of the Plan

currency_rate string Exchange rate used for generating the Charge

currency_unit integer Currency units used for generating the Charge

billing_date date Start date of the related Billing period

relationships array Related objects

reseller array Reseller information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

account array Account information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

subscription array Subscription information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

plan array Plan information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

manager array Manager information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

plan_resource array Plan Resource information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

discount array Discount information

data

array

Related object information:

Name		Data type	Description
id		integer	ID of the object
type		string	Data type

included

array

Additional information about objects listed in the request:

Name	Data type	Description
id	integer	ID of the object
type	string	Data type
attributes	array	Attributes of the object (see details below)

Attributes of the object:

- For the Reseller, see the data model in Get downstream Reseller information by ID
- For the Account, see the data model in Get the Reseller's Account Info by ID
- For the Subscription:

Name			Data type	Description
id			integer	ID of the Subscription
type			string	Data type
attributes			array	Subscription details
	created_at		date	Date and time of the Subscription creation
	updated_at		date	Date and time when the Subscription was updated
	auto_renewal		bool	The automatic Subscription renewal option: false — The automatic Subscription renewal is off. true — The automatic Subscription renewal is enabled
	billing_from		date	The start date of generating Charges for the Subscription
	expiration_date		date	The expiration date of the Subscription
	name		string	Name of the Subscription
	renew_point_days		integer	A number of days before the Subscription expires when the Customer receives the bill for Subscription renewal
	start_date		date	The date of activation of the Subscription
	status		string	Status of the Subscription (for the list of Subscription statuses, see Viewing the list of Subscriptions)
	payment_model		string	Subscription payment model: prepay postpay
	payment_model_parameters		object	Payment model parameters
		credit_limit	float	The value of the Subscription debt, above which the postpaid Subscription will be stopped. For postpaid Subscription only (payment_model = postpay)
		current_debt	float	The Subscription debt that is calculated as the total amount of all blocked Charges for the Subscription for the current Billing period. For postpaid Subscription only (payment_model = postpay)

- For the Plan, see the data model in Get the Reseller's Plan information by ID
- For the Discount:

Name		Data type	Description
id		string	ID of the Discount
type		string	Data type
attributes		object	Discount details
	created_at	string	Date and time of the Discount creation
	updated_at	string	Date and time when the Discount was updated
	name	string	Discount name
	status	string	Discount status: active — Discount is available for new Orders. inactive — Discount is not available for new Orders.
	type	string	Discount type (for Discount types, see Managing discounts)
	percentage	string	Discount amount as a percentage
	duration_from	string	Start date of the Discount period (in the YYYY-MM-DD format)
	duration_to	string	End date of the Discount period (in the YYYY-MM-DD format)

Request example

GET /api/v3/resellers/230/reseller_charges/1310?include=reseller,account,subscription,plan,discount
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example

{
    "data": {
        "id": "1310",
        "type": "reseller_charges",
        "attributes": {
            "created_at": "2018-05-25T14:50:24.472+03:00",
            "updated_at": "2018-05-25T14:50:24.472+03:00",
            "charge_id": 43784,
            "subscription_id": 3003965,
            "unit_price": "5.0",
            "amount": "60.0",
            "net_cost": 60,
            "subscription_resource_id": 24996,
            "subscription_resource_name": "Resource 1",
            "plan_resource_id": 2940,
            "resource_id": 8,
            "quantity": 1,
            "operate_from": "2018-05-25",
            "operate_to": "2019-05-24",
            "duration": 12,
            "description": "Upgrade resource (recurring fee) \"Resource 1\" for Subscription #3003965 \"CSP plan with resources\"",
            "type": "Charge::Recurring",
            "order_id": 4919,
            "additional_params": [],
            "discount": "0.00",
            "original_amount": "60.0",
            "original_amount_currency": "USD",
            "currency_rate": "1.0",
            "currency_unit": 1,
			"billing_date": "2018-05-05"
        },
        "relationships": {
            "reseller": {
                "data": {
                    "id": "230",
                    "type": "resellers"
                }
            },
            "account": {
                "data": {
                    "id": "278",
                    "type": "accounts"
                }
            },
            "subscription": {
                "data": {
                    "id": "3003965",
                    "type": "subscriptions"
                }
            },
            "plan": {
                "data": {
                    "id": "847",
                    "type": "plans"
                }
            },
            "manager": {
                "data": {
                    "id": "186",
                    "type": "managers"
                }
            },
            "plan_resource": {
                "data": {
                    "id": "2940",
                    "type": "plan_resources"
                }
            },
            "discount": {
                "data": null
            }
        }
    },
    "included": [
        {
            "id": "230",
            "type": "resellers",
            "attributes": {
                "created_at": "2017-10-12T14:21:59.236+03:00",
                "updated_at": "2018-07-26T07:30:35.463+03:00",
                "parent_id": 229,
                "general": {
                    "created_at": "2017-10-12T14:21:59.236+03:00",
                    "updated_at": "2018-07-26T07:30:35.463+03:00",
                    "name": "SL 365",
                    "domain": "test.activeplatform.com",
                    "manager": "slt1manager",
                    "currency": "USD"
                },
                "company": {
                    "created_at": "2017-10-12T14:21:59.236+03:00",
                    "updated_at": "2018-07-26T07:30:35.463+03:00",
                    "city": "Minsk",
                    "zip": "",
                    "country": "BY",
                    "fax": "",
                    "name": "Acme",
                    "address_line_1": "Mira",
                    "address_line_2": "1",
                    "state": "",
                    "phone": "+375290000000",
                    "email": ""
                },
                "contacts": {
                    "created_at": "2017-10-12T14:21:59.236+03:00",
                    "updated_at": "2018-07-26T07:30:35.463+03:00",
                    "first_name": "Adam",
                    "last_name": "Smith",
                    "middle_name": "",
                    "position": "",
                    "phone": "+375290000000",
                    "email": "example@gmail.com"
                },
                "custom_attributes": {}
            }
        },
        {
            "id": "278",
            "type": "accounts",
            "attributes": {
                "created_at": "2018-07-06T10:41:59.558+03:00",
                "updated_at": "2019-02-01T16:51:37.908+03:00",
                "reseller_id": 230,
                "name": "Виталий  Комич",
                "account_class_id": 954,
                "primary_name": "",
                "first_name": "Виталий",
                "middle_name": "",
                "last_name": "Комич",
                "country": "BY",
                "region": "Минская",
                "city": "Минск",
                "street": "Кальварийская",
                "building": "",
                "office": "",
                "zip": "112305",
                "phone": "+375440000000",
                "email": "example@activeplatform.com",
                "status": "active",
                "balance": "99543.98",
                "usable_balance": "99514.96",
                "current_debt": 0,
                "subscription_credit_limit": 0,
                "financial_blocking_threshold": 100,
                "account_type_id": 3938,
                "manager_id": null,
                "owner_id": 659,
                "tech_user_id": 659,
                "bill_user_id": 659,
                "custom_attributes": {},
                "manager": null,
                "default_payment_model": "prepay",
                "account_type": {
                    "id": 3938,
                    "name": "Физическое лицо",
                    "created_at": "2017-10-12T14:21:59.392+03:00",
                    "updated_at": "2017-10-12T14:21:59.392+03:00",
                    "reseller_id": 230,
                    "name_pattern": "%first_name %middle_name %last_name",
                    "primary_name": "",
                    "key": "personal",
                    "default_payment_method_id": null,
                    "ancestry": "1562/1564/3933",
                    "use_by_default": false
                },
                "account_class": {
                    "id": 954,
                    "reseller_id": 230,
                    "name": "Default",
                    "created_at": "2017-10-12T14:22:00.507+03:00",
                    "updated_at": "2019-02-07T15:42:39.112+03:00",
                    "financial_blocking_threshold": "100.0",
                    "due_order_period": 14,
                    "subzero_period": 5,
                    "stop_subscription_type": "automatically",
                    "key": "default",
                    "color": "grey",
                    "guaranteed_payment_limit": 1000,
                    "guaranteed_payment_period": 7,
                    "delete_subscription_type": "automatically",
                    "denominated": false,
                    "buy_with_negative_balance": true,
                    "receipt_day": null,
                    "payment_model": "prepay",
                    "default": false,
                    "due_payment_period": 30,
                    "subscription_credit_limit": "0.0"
                }
            },
            "relationships": {
                "subscriptions": {
                    "data": [
                        {
                            "id": "3003911",
                            "type": "subscriptions"
                        },
                        {
                            "id": "3003965",
                            "type": "subscriptions"
                        }
                    ]
                }
            }
        },
        {
            "id": "3003965",
            "type": "subscriptions",
            "attributes": {
                "created_at": "2018-05-25T14:49:57.934152+0300",
                "updated_at": "2019-06-09T07:15:24.603637+0300",
                "auto_renewal": false,
                "billing_from": "2018-05-25",
                "expiration_date": "2019-05-25",
                "name": "CSP plan with resources",
                "renew_point_days": 0,
                "start_date": "2018-05-25",
                "status": "deleted",
                "payment_model": "prepay",
                "payment_model_parameters": {}
            }
        },
        {
            "id": "847",
            "type": "plans",
            "attributes": {
                "created_at": "2018-07-06T11:27:20.029+03:00",
                "updated_at": "2020-01-04T11:13:18.206+03:00",
                "status": "active",
                "name": "CSP plan with resources",
                "description": "",
                "public": true,
                "plan_class_id": 3866,
                "product_id": 555,
                "billing_type": "csp_monthly",
                "ancestry": "12",
                "reseller_id": 229,
                "plan_class": "CSP monthly",
                "product_category_id": 536,
                "product_category": "default",
                "product": "Default",
                "plan_resources": {
                    "data": [
                        {
                            "id": "2938",
                            "type": "plan_resources",
                            "attributes": {
                                "created_at": "2018-07-06T11:27:20.114+03:00",
                                "updated_at": "2018-07-06T11:27:20.114+03:00",
                                "name": "Resource 1",
                                "measurable": false,
                                "unit_of_measure": "unit",
                                "application_template_name": "Auto provisioning",
                                "included": 0,
                                "minimum": 1,
                                "limit": 0,
                                "setup_fee": "0.0",
                                "recurring_fee": "5.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0",
                                "unlimited_units": true,
                                "public": true,
                                "status": "active",
                                "resource_id": 8,
                                "custom_attributes": {}
                            }
                        },
                        {
                            "id": "2939",
                            "type": "plan_resources",
                            "attributes": {
                                "created_at": "2018-07-06T11:27:20.122+03:00",
                                "updated_at": "2018-07-06T11:27:20.122+03:00",
                                "name": "Resource 2",
                                "measurable": false,
                                "unit_of_measure": "unit",
                                "application_template_name": "Auto provisioning",
                                "included": 0,
                                "minimum": 0,
                                "limit": 0,
                                "setup_fee": "0.0",
                                "recurring_fee": "5.0",
                                "overuse_fee": "0.0",
                                "renewal_fee": "0.0",
                                "unlimited_units": true,
                                "public": true,
                                "status": "active",
                                "resource_id": 9,
                                "custom_attributes": {}
                            }
                        }
                    ]
                },
                "plan_periods": {
                    "data": [
                        {
                            "id": "1687",
                            "type": "plan_periods",
                            "attributes": {
                                "created_at": "2018-07-06T11:27:20.082+03:00",
                                "updated_at": "2018-07-06T11:27:20.082+03:00",
                                "duration_value": 1,
                                "duration_type": "month",
                                "setup_fee": "1.0",
                                "recurring_fee": "1.0",
                                "transfer_fee": "17.0",
                                "renewal_fee": "15.0",
                                "trial": false,
                                "public": true,
                                "status": "active",
                                "description": ""
                            }
                        },
                        {
                            "id": "1675",
                            "type": "plan_periods",
                            "attributes": {
                                "created_at": "2018-07-06T11:27:20.037+03:00",
                                "updated_at": "2018-07-06T11:27:20.037+03:00",
                                "duration_value": 1,
                                "duration_type": "year",
                                "setup_fee": "0.0",
                                "recurring_fee": "0.0",
                                "transfer_fee": "0.0",
                                "renewal_fee": "0.0",
                                "trial": false,
                                "public": true,
                                "status": "active",
                                "description": ""
                            }
                        }
                    ]
                },
                "available_account_types": [
                    {
                        "id": 3927,
                        "name": "Personal BLR",
                        "created_at": "2017-10-12T13:44:58.444+03:00",
                        "updated_at": "2017-10-12T13:44:58.444+03:00",
                        "reseller_id": 229,
                        "name_pattern": "%first_name %middle_name %last_name",
                        "primary_name": "",
                        "key": "personalblr",
                        "default_payment_method_id": 2,
                        "ancestry": "1",
                        "use_by_default": false
                    },
                    {
                        "id": 3931,
                        "name": "Business BLR",
                        "created_at": "2017-10-12T13:44:58.474+03:00",
                        "updated_at": "2017-10-12T13:44:58.474+03:00",
                        "reseller_id": 229,
                        "name_pattern": "%primary_name",
                        "primary_name": "Company name",
                        "key": "businessblr",
                        "default_payment_method_id": 197,
                        "ancestry": "2",
                        "use_by_default": false
                    }
                ],
                "plan_currency": "EUR",
                "custom_attributes": {
                    "item_1c_for_resellers": "",
                    "vat25": "0"
                }
            }
        }
    ]
}