Accessing regulatory fee information
Learn how to access regulatory fee information.
Last updated
Learn how to access regulatory fee information.
Last updated
When regulatory fees are applied to products in a transaction, you can access both aggregated and product-level information on these fees. This allows you to provide customers transparency into the transaction's fee types, their costs, and which products the fees apply to.
You can find their aggregated amount in the totalFees
attribute for transactions with one or more assessed regulatory fees. This attribute is contained in the , , and resources. The totalFees
value does not include taxes assessed on a transaction's regulatory fees. Instead, fee taxes are rolled up into the totalTax
value.
For each line item with applied regulatory fees, we return fees.amount
. This represents the amount of fees applied to the total quantity
of that particular line item. For example, if the line item consists of two mobile phones, fees.amount
is the aggregated fee amount applied to both devices. The fees.taxAmount
represents taxes assessed on these line item fees.
Fee
Checkout
Order
id
âž”
items[].fees.details[].id
âž”
items[].fees.details[].id
type
âž”
items[].fees.details[].type
âž”
items[].fees.details[].type
amount
âž”
items[].fees.details[].perUnitAmount
âž”
items[].fees.details[].perUnitAmount
The same relationship exists between Fees and Invoices:
Fee
Invoice
id
âž”
items[].fees.details[].id
type
âž”
items[].fees.details[].type
amount
âž”
items[].fees.details[].perUnitAmount
The details[].amount
is determined by multiplying details[].perUnitAmount
by the quantity
of that line item.
If you and add that SKU to a checkout, we return information on each applied fee. In , , and , this information is contained within items[].fees.details[]
.
The data in this array is useful when multiple regulatory fees are associated with a SKU. Each element in the array provides a fee's unique id
, the , the perUnitAmount
, and the amount
. The following table shows how some of these attributes are mapped within the , Checkout, and Order resources.
In the following example, a physical SKU is created and associated with two separate regulatory fees. The first is a with an amount
of 5.0
. The second is a with an amount
of 3.0
.
The SKU is then attached to a checkout. Since there are now two regulatory fees associated with this checkout's sole line item, details[]
contains two elements. Each element maps to one of the applied regulatory fees. When the , the returned fees data remains the same.
You can use this information to provide customers with detailed regulatory fee information. In the example below, you could inform customers that both a and regulatory fee are applied to the product and provide a cost breakdown for each.