Skip to main content
Understand how Dollr calculates gateway and platform fees before and after transactions. Try in API Reference: Gateway fees · Platform fees · Merchant tier · List tiers

​
When to use

  • Display fee breakdown in your checkout UI
  • Reconcile settlements with Predictions for live quotes
Fee bearer on invoices/orders (PAYER vs PAYEE) controls whether the customer pays fees on top of the total.

​
Gateway fees

Per payment method and operation type: 
curl "https://api.heydollr.app/v1/fees/gateway?payment_method=MTN_MOMO_LBR&operation_type=COLLECTION" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
payment_method values include MTN_MOMO_LBR, ORANGE_MONEY_LBR, AIRTEL_RWA, MTN_MOMO_RWA, ORANGE_MONEY_RWA, CREDIT_CARD, and WALLET.

​
Platform fees

curl "https://api.heydollr.app/v1/fees/platform?operation_type=COLLECTION&fee_tier_name=default" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Merchant fee tier

curl "https://api.heydollr.app/v1/fees/merchant-tier?owner_type=ORGANIZATION&owner_id=42" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
owner_type: USER, MICRO_ORGANIZATION, or ORGANIZATION.

​
List all tiers

curl "https://api.heydollr.app/v1/fees/tiers" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Returns all platform fee tiers with name, is_default, and timestamps.

​
Discover your fee tier

# List all tiers
curl "https://api.heydollr.app/v1/fees/tiers" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Your assigned tier
curl "https://api.heydollr.app/v1/fees/merchant-tier?owner_type=ORGANIZATION&owner_id=42" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Use the tier name from merchant-tier response as fee_tier_name in platform fee queries. Default tier name is often default for new merchants.
Last modified on June 23, 2026