Skip to main content

List Fees

GET 
/fees

Lists merchant processing fee records (card/network cost to the merchant). Pass a LoopBack-style filter query object for pagination (filter[limit], filter[skip], filter[order]).

Not payer fees: For payer-side recoup/surcharge at checkout, use Split Fees or feeSplit on Get Payment (payerTotalFees, merchantTotalFees).

Integrations API credentials: Some merchant Integrations OAuth tokens return 401 (insufficientResourceAccess) on this route — this is a token scope limitation, not a wrong X-CUSTOMER-ID (the same token typically works for payments and Split Fees). When List Fees is unavailable, use Get Payment embedded fees[] (merchant processing) and feeSplit (payer-side), or subscribe to Fee Events.

Integrations API credentials: Some merchant Integrations OAuth tokens return 401 (insufficientResourceAccess) on this route. When that happens, use Get Payment — the response includes embedded fees[] and feeSplit — or subscribe to Fee Events.

Fee rows are also emitted via Fee Events webhooks. See Payment and fee reconciliation.

Request​

Responses​

List of fees