> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heydollr.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose Your Integration

> Pick the right Dollr API flow — hosted checkout, invoice collection, payouts, or realtime updates.

Use this page to pick a starting path. Every flow uses the same [authentication](/authentication) and [API conventions](/api-conventions).

## Collection (money in)

| Path                                 | Best when                                                                              | Start here                                                          |
| ------------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Hosted checkout**                  | Customer pays on Dollr page with mobile money or card; minimal backend                 | [Hosted checkout](/guides/hosted-checkout)                          |
| **Invoice / order (document-first)** | You issue formal bills or e-commerce orders; you control line items and publish timing | [Quick Start](/quickstart) · [Node.js](/guides/collect-with-nodejs) |
| **Direct checkout**                  | One API call to create source from payer details                                       | [Collect via checkout](/guides/collect-via-checkout)                |
| **Payment link only**                | Share a URL for a published invoice/order                                              | [Payment links](/api/links)                                         |
| **Card in your UI**                  | Stripe Elements in your own checkout                                                   | [Collect with card](/guides/collect-with-card)                      |

<Steps>
  <Step title="Hosted (fastest)">
    `POST /v1/checkouts/create` with `mode: "HOSTED"` → redirect to `url` → customer pays with MoMo or card.
  </Step>

  <Step title="Document-first (API-embedded)">
    Party → counterparty → invoice/order → publish → checkout session → payment account → execute → poll status.
  </Step>

  <Step title="Checkout shortcut (API-embedded)">
    `POST /v1/checkouts/create` → session → payment account → execute.
  </Step>
</Steps>

## Payouts (money out)

| Path       | Best when                                     | Start here                                                                                                  |
| ---------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Payout** | Send to a mobile wallet or registered account | [Payout with Node.js](/guides/payout-with-nodejs) · [Integration guide](/guides/integration#issue-a-payout) |

## Status updates

| Path                 | Best when                                | Start here                                                           |
| -------------------- | ---------------------------------------- | -------------------------------------------------------------------- |
| **Polling**          | Simple backends; few concurrent payments | `GET /v1/status/collection/{reference_id}` — [Status](/api/status)   |
| **Source status**    | Hosted checkout success page             | `GET /v1/status/source` — [Hosted checkout](/guides/hosted-checkout) |
| **Realtime keys**    | Live UI; reduce polling load             | [Realtime status](/guides/realtime-status)                           |
| **Backend patterns** | No webhooks — how to verify on server    | [Payment status patterns](/guides/payment-status-patterns)           |

## Markets & methods

Before executing, confirm the customer's **method** and **provider** for their country: [Payments by market](/reference/payments-by-market).

Optional: `GET /v1/predictions/mmo-provider-info` to infer MoMo operator from phone — [Predictions](/api/predictions).

## Try it yourself

<CardGroup cols={2}>
  <Card title="Hosted checkout" icon="window-maximize" href="/guides/hosted-checkout">
    Mobile money and card on a Dollr payment page.
  </Card>

  <Card title="API Reference playground" icon="play" href="/api-reference/executions/collect">
    Run collect, payout, and status calls interactively.
  </Card>
</CardGroup>