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
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)
For a published source, 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:
Response fields:
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:
Receipts include payer_amount, payee_amount, fx_rate, fx_currency_from, fx_currency_to, and fee breakdowns.
Last modified on June 23, 2026
