comecerodocs
Refunds

Get a refund's fee summary

GET
/refunds/{refund_id}/fee_summary

Returns the Comecero fees on one refund, 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

refund_id*string

The refund 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/refunds/string/fee_summary'
Example Response
{  "object": "fee_summary",  "url": "https://api.comecero.com/api/v1/refunds/0090374314462Rec3PffZ5/fee_summary",  "fixed_amount": 0,  "percentage_amount": 0,  "total": 0.25,  "currency": "USD",  "totals": [    {      "currency": "USD",      "fixed_amount": 0,      "percentage_amount": 0,      "total": 0.25    }  ]}

Complete a pending refund POST

Marks a `pending` refund `completed` without asking the payment provider again. For staff use when a refund did go through but Comecero never heard back. Completing it records fees and commissions, fires `refund:created_success` and sends the customer the refund email. A refund that is not pending comes back unchanged. No body is read. Only Comecero staff (admin tokens) may call this. Secret, trusted and limited tokens get `403`.

List a refund's fees GET

Lists the Comecero fees recorded for one refund. Offset-based (`offset`, `limit`). `sort_by` takes `date_created` (default) or `date_modified`. Needs a secret or trusted token that may read fees. Limited tokens get `403`.