Collection (money in)
| Path | Best when | Start here |
|---|---|---|
| Hosted checkout | Customer pays on Dollr page with mobile money or card; minimal backend | Hosted checkout |
| Invoice / order (document-first) | You issue formal bills or e-commerce orders; you control line items and publish timing | Quick Start · Node.js |
| Direct checkout | One API call to create source from payer details | Collect via checkout |
| Payment link only | Share a URL for a published invoice/order | Payment links |
| Card in your UI | Stripe Elements in your own checkout | Collect with card |
Hosted (fastest)
POST /v1/checkouts/create with mode: "HOSTED" → redirect to url → customer pays with MoMo or card.Document-first (API-embedded)
Party → counterparty → invoice/order → publish → checkout session → payment account → execute → poll status.
Payouts (money out)
| Path | Best when | Start here |
|---|---|---|
| Payout | Send to a mobile wallet or registered account | Payout with Node.js · Integration guide |
Status updates
| Path | Best when | Start here |
|---|---|---|
| Polling | Simple backends; few concurrent payments | GET /v1/status/collection/{reference_id} — Status |
| Source status | Hosted checkout success page | GET /v1/status/source — Hosted checkout |
| Realtime keys | Live UI; reduce polling load | Realtime status |
| Backend patterns | No webhooks — how to verify on server | Payment status patterns |
Markets & methods
Before executing, confirm the customer’s method and provider for their country: Payments by market. Optional:GET /v1/predictions/mmo-provider-info to infer MoMo operator from phone — Predictions.
Try it yourself
Hosted checkout
Mobile money and card on a Dollr payment page.
API Reference playground
Run collect, payout, and status calls interactively.