comecerodocs

Get an order's fee summary

GET
/orders/{order_id}/fee_summary

Returns the Comecero fees on the order: the fees of all its payments and their refunds, added up per currency.

Needs a secret or trusted token that may read fees. Limited tokens are refused. A token without the fees permission gets 401, not 403.

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

order_id*string

The order id.

Query Parameters

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Response Body

The fee summary.

application/json
  1. response

The Comecero fees charged on a payment, a refund or a whole order, added up. An order's summary adds the fees of all its payments and their refunds. Amounts in different currencies are never added together: the top-level amounts are in currency, and totals has one entry per currency.

object*"fee_summary"

The object type. Always fee_summary.

Value in"fee_summary"
url*|

The URL of this summary. Null when no fees were recorded.

Formaturi
fixed_amount*number

The sum of the fixed fees, in currency.

percentage_amount*number

The sum of the percentage fees, in currency.

total*number

fixed_amount plus percentage_amount, in currency.

currency*|

The currency of the top-level amounts (the first payment's fee currency). Null when no fees were recorded.

totals*array<>

The sums for each currency, the top-level currency first.

formatted?

Display text. Only present when you send formatted=true.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/orders/string/fee_summary'
Example Response
{  "object": "fee_summary",  "url": "https://api.comecero.com/api/v1/orders/7393-GMRFY-954/fee_summary",  "fixed_amount": 0.3,  "percentage_amount": 2.25,  "total": 2.55,  "currency": "USD",  "totals": [    {      "currency": "USD",      "fixed_amount": 0.3,      "percentage_amount": 2.25,      "total": 2.55    }  ]}