Fees - Dollr Developer Docs

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.

​When to use

​Gateway fees

​Platform fees

​Merchant fee tier

​List all tiers

​Discover your fee tier

​Related