onetime, reusable, collect, withdrawal) and optionally by payment method. There are two related endpoints: one for fee rates, and one for the fee calculated against a specific transaction amount.
Get fee rates
Returns the fee structure (percentage or flat rate) for a given transaction type.GET /merchants/{merchantID}/fees
Authentication
Accepts a Bearer token (Authorization: Bearer <token>) or an API key (X-Api-Key: <key>).
Path parameters
string
required
The UUID of the merchant.
Query parameters
string
required
The transaction type to retrieve fees for. One of:
onetime, reusable, collect, withdrawal.integer
The payment method ID to filter fees for. If omitted, the default fee structure for the type is returned.
Response fields
string
required
The transaction type the fee applies to.
string
The fee as a percentage of the transaction amount (e.g.,
"1.50" for 1.5%).string
A flat fee amount applied per transaction.
Example request
Example response
Get fees for a transaction amount
Calculates the actual fee amounts for a specific transaction value.GET /merchants/{merchantID}/fees/amount
Authentication
Accepts a Bearer token (Authorization: Bearer <token>) or an API key (X-Api-Key: <key>).
Path parameters
string
required
The UUID of the merchant.
Query parameters
string
required
The transaction type. One of:
onetime, reusable, collect, withdrawal.string
required
The transaction amount as a decimal string. The fee is calculated against this value.
integer
The payment method ID. If omitted, the default fee structure for the type is used.
Response fields
string
required
The transaction type the fee applies to.
string
required
The total fee amount in the same unit as the
amount query parameter.string
required
The amount after fees are deducted.