Dollr supports collecting in currencies that differ from your invoice or order currency (for example, invoice in USD, payer pays in LRD via mobile money). Predictions tell you the amounts before you execute; receipts show what actually settled.
Three amounts to track
| Concept | Where it appears | Meaning |
|---|
| Source total | Invoice/order currency + total_amount | What you billed |
| Payer amount | Prediction + execution + receipt | What the customer pays (including fees if fee_bearer: PAYER) |
| Payee amount | Prediction + execution + receipt | What you receive after fees and FX |
Fee bearer
Set on invoice/order create (PAYER or PAYEE):
PAYER — Customer pays platform/gateway fees on top of the source totalPAYEE — You absorb fees; customer pays the listed total
Preview with predictions before executing.
Which currency on execute?
For POST /v1/executions/collection, pass the currency the payer is paying in — typically the target_currency from your prediction, not necessarily the invoice currency.
Example: Invoice USD 100, payer uses MTN MoMo in LRD:
- Call predictions with
base_currency=USD, target_currency=LRD
- Use returned
payer_currency / amounts to show the customer the LRD total
- Execute with
"currency": "LRD" (payer currency)
curl "https://api.heydollr.app/v1/predictions/payment-source/amount-and-fees?source_type=INVOICE&source_id=101&target_currency=LRD&payment_method=MTN_MOMO_LBR&provider=PAWAPAY" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
payment-source/amount-and-fees uses the source total as the base — you only choose target_currency and payment routing.
Standalone amount prediction
When you know the base amount upfront:
curl "https://api.heydollr.app/v1/predictions/amount-and-fees?base_amount=100&base_currency=USD&target_currency=LRD&payment_method=MTN_MOMO_LBR&operation_type=COLLECTION&provider=PAWAPAY&fee_bearer=PAYER" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
| Field | Description |
|---|
payer_amount / payer_currency | Customer pays |
payee_amount / payee_currency | You receive |
platform_fee | Dollr platform fee |
gateway_fee | MoMo/card gateway fee |
fx_fee | FX conversion fee (if applicable) |
Hosted checkout
On hosted checkout, Dollr handles currency selection and FX on the payment page. You still verify settlement via GET /v1/status/source or receipt endpoints.
Receipt reconciliation
After PAID, use:
GET /v1/invoices/receipt/{id}
payer_amount, payee_amount, fx_rate, fx_currency_from, fx_currency_to, and fee breakdowns.
Last modified on June 23, 2026
