POST /v1/checkouts/create when you do not want to manually create a party, counterparty, and invoice/order first. Dollr creates or matches the payer and returns source_id, party_id, and counterparty_id when applicable.
API Reference: Create checkout source
When to use
- E-commerce checkout where payer details are known at cart time
- Faster prototyping than the document-first Quick Start
- Hosted checkout with
mode: "HOSTED"— redirect tourlfor mobile money or card
Hosted flow (recommended for most integrations)
Authenticate
See Authentication.
Create hosted checkout source
mode: "HOSTED", source_kind (INVOICE or ORDER), payer details, items[], and optional success_url / cancel_url.Redirect customer
Send the customer to the
url in the response. They pay with mobile money or card on Dollr’s hosted page.Confirm payment
GET /v1/status/source?source_type=INVOICE&source_id={source_id} or Realtime status.API-embedded flow
If you build your own payment UI:Checkout session → payment account → execute
POST /v1/sessions/checkout, register a payment account, then POST /v1/executions/collection with a stored UUID reference_id.Poll or subscribe
GET /v1/status/collection/{reference_id} or Realtime status.