List a refund's commissions
Lists the commissions recorded for one refund. A refund takes back the commission paid on the sale, so the totals are negative. Offset-based (offset, limit). sort_by takes date_created (default) or date_modified. Note that the paging URLs in the response point to /payments/{refund_id}/commissions; build the next page URL from next_page_offset instead.
Needs a secret or trusted token that may read commissions. Limited tokens get 403.
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
refund_id*stringThe refund id.
type?"product_sales"Only commissions of this type.
"product_sales"offset?integerFor offset-based lists, how many items to skip before the page starts. Use next_page_offset or previous_page_offset from the page you have. A value that is not a whole number is a 400.
0 <= value0limit?integerHow many items to return on one page, from 1 to 100. The default is 100. A value outside 1 to 100, or one that is not a whole number, is a 400.
1 <= value <= 100100desc?booleanSort in descending order (newest, largest or last first) when true. The default is false. A value other than true or false is a 400.
falsesort_by?stringThe field to sort by.
"date_created""date_created""date_modified"expand?stringComma-separated child objects to return in full instead of as a URL, for example customer,payments. Use dot notation for nested objects (items.product), up to four levels deep. A single object takes up to 12 paths; a list takes up to 2, applied to every item. Extra paths are dropped without an error. See Expanding objects.
show?stringComma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
hide?stringComma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.
formatted?booleanWhen 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.
falseAn offset-based page of commissions.
application/json- response
A page of an offset-based list. Move between pages with offset, or follow next_page_url and previous_page_url, which keep your other query parameters.
total_items*integerHow many items match, across all pages.
total_pages*integerHow many pages there are at this limit. 0 when nothing matches.
current_page*integerThe number of this page, starting at 1. 0 when nothing matches.
next_page_url*|The URL of the next page, or null on the last page.
urinext_page_offset*|The offset of the next page, or null on the last page.
previous_page_url*|The URL of the previous page, or null on the first page.
uriprevious_page_offset*|The offset of the previous page, or null on the first page.
current_page_url*stringThe URL of this page.
uridata*array<>The commissions on this page.
curl -X GET 'https://api.comecero.com/api/v1/refunds/string/commissions'{ "total_items": 1, "total_pages": 1, "current_page": 1, "next_page_url": null, "next_page_offset": null, "previous_page_url": null, "previous_page_offset": null, "current_page_url": "https://api.comecero.com/api/v1/refunds/0090374314462Rec3PffZ5/commissions", "data": [ { "object": "commission", "url": "https://api.comecero.com/api/v1/commissions/0090374314511CoH6tPz4v", "commission_id": "0090374314511CoH6tPz4v", "date_created": "2026-11-03T10:12:41Z", "date_modified": "2026-11-03T10:12:41Z", "test": true, "total": -49.95, "currency": "USD", "type": "product_sales", "description": null, "transaction_type": "refund", "transaction": "https://api.comecero.com/api/v1/refunds/0090374314462Rec3PffZ5", "accounting_id": "C-AB1234R261130USD" } ]}Delete a refund DELETE
Removes a chargeback or record-only refund that was entered by mistake. Only works for a refund with `is_chargeback` or `record_only` set, on a gateway that belongs to your account; any other refund gets `422`. No money moves: a refund that really sent money back cannot be deleted. The refund is removed from reports and the `refund:deleted` event fires. Needs a secret or trusted token. Limited tokens get `403`.
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`.