Skip to main content

Overview

Custom fees enable service providers to add their own fees to payment requests, supporting business models that require fee collection from transactions.

Fee Types

Fixed Fees

Absolute amount in any currency

Percentage Fees

Relative fees based on payment amount

How It Works

Fee Collection:
  • Automatic: Fees collected during payment
  • Split: Separate fee recipient addresses
  • Transparent: Clear fee breakdown for payers

Fee Configuration

Service Provider Fees

  • Platform Fee: Your service commission
  • Processing Fee: Payment handling charges
  • Custom Fee: Application-specific charges

Network Fees

  • Gas Optimization: Efficient transaction bundling
  • Cross-chain: Bridge and routing fees
  • Multi-token: Token conversion costs

Fee Recipients

Single Recipient

All fees collected to one address

Multiple Recipients

Split fees across multiple addresses with defined percentages

Fee Tokens

  • Same Currency: Fees in request currency
  • Different Currency: Fees in alternative tokens
  • Multi-currency: Mixed fee structures

Integration Patterns

SaaS Platforms

Platform commission on transactions

Payment Processors

Processing fees and margins

Detailed Fee Breakdowns

Complete fee transparency including USD amounts available in payment queries and responses.

Implementation Details

See API Reference - Custom Fees for complete technical documentation.