> ## 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.

# Overview

> Dollr is a payment infrastructure platform for businesses operating in Africa. It provides a single unified REST API to collect payments, send payouts, process transfers, and issue refunds — abstracting mobile money operators and card networks into a clean, consistent interface.

# Dollr OAPI

**Version:** v1  ·  **Base URL:** `https://api.heydollr.app`

Dollr is a payment infrastructure platform for businesses operating in Africa. It provides a single unified REST API to collect payments, send payouts, process transfers, and issue refunds — abstracting mobile money operators and card networks into a clean, consistent interface.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    First collection in under 10 minutes — invoice flow with cURL, Python, and Node.js.
  </Card>

  <Card title="Build with AI" icon="sparkles" href="/agentic-development">
    Agentic development — AI assistants, MCP, prompts, and guardrails for Dollr.
  </Card>

  <Card title="Choose your integration" icon="route" href="/guides/choose-integration">
    Invoice, checkout shortcut, payout, or realtime — pick the right path.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    OAuth 2.0 client credentials, token refresh, and API keys from the merchant portal.
  </Card>
</CardGroup>

## Integrate by stack

<CardGroup cols={3}>
  <Card title="Node.js" icon="node-js" href="/guides/collect-with-nodejs">
    Server-side JavaScript with `fetch`.
  </Card>

  <Card title="Python" icon="python" href="/guides/collect-with-python">
    Invoice collection with `requests`.
  </Card>

  <Card title="Django" icon="django" href="/guides/collect-with-django">
    Service layer + `requests` in Django.
  </Card>

  <Card title="Ruby" icon="gem" href="/guides/collect-with-ruby">
    Invoice collection with Net::HTTP.
  </Card>

  <Card title="PHP" icon="php" href="/guides/collect-with-php">
    cURL or Guzzle from PHP 8.1+.
  </Card>

  <Card title="Java" icon="java" href="/guides/collect-with-java">
    `HttpClient` and JSON on the JVM.
  </Card>

  <Card title="Go" icon="golang" href="/guides/collect-with-go">
    `net/http` and `encoding/json`.
  </Card>

  <Card title="Rust" icon="rust" href="/guides/collect-with-rust">
    `reqwest` + `serde` async client.
  </Card>

  <Card title=".NET" icon="microsoft" href="/guides/collect-with-dotnet">
    C# `HttpClient` and `System.Text.Json`.
  </Card>

  <Card title="Next.js" icon="react" href="/guides/collect-with-nextjs">
    Route Handlers and Server Actions.
  </Card>

  <Card title="Laravel" icon="laravel" href="/guides/collect-with-laravel">
    Laravel HTTP client and config.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Hosted checkout" icon="window-maximize" href="/guides/hosted-checkout">
    Customer pays with mobile money or card on a Dollr-hosted page.
  </Card>

  <Card title="Payout with Node.js" icon="arrow-up-right" href="/guides/payout-with-nodejs">
    Send mobile-money payouts from Node.js.
  </Card>

  <Card title="Direct checkout" icon="cart-shopping" href="/guides/collect-via-checkout">
    One call to create source + session — skip manual party/invoice steps.
  </Card>

  <Card title="Integration guide" icon="map" href="/guides/integration">
    Full collection and payout walkthroughs.
  </Card>
</CardGroup>

## Explore

<CardGroup cols={2}>
  <Card title="Payments by market" icon="globe" href="/reference/payments-by-market">
    MTN, Orange, Airtel, cards — methods and providers by country.
  </Card>

  <Card title="Sessions & executions" icon="bolt" href="/concepts/sessions-and-executions">
    How checkout sessions, idempotent executions, and status polling work.
  </Card>

  <Card title="Error catalog" icon="triangle-exclamation" href="/reference/error-catalog">
    Common API errors, causes, and fixes.
  </Card>

  <Card title="API Reference" icon="braces" href="/api-reference/jwt/client-obtain-token">
    Interactive OpenAPI docs — try every endpoint in the browser.
  </Card>

  <Card title="AI & MCP" icon="robot" href="/reference/ai-context">
    llms.txt, docs MCP URL, and LLM integration guardrails.
  </Card>
</CardGroup>

## Supported payment methods

| Method              | Identifier         | Market             |
| ------------------- | ------------------ | ------------------ |
| MTN Mobile Money    | `MTN_MOMO_LBR`     | Liberia            |
| Orange Money        | `ORANGE_MONEY_LBR` | Liberia            |
| Airtel Money        | `AIRTEL_RWA`       | Rwanda             |
| MTN Mobile Money    | `MTN_MOMO_RWA`     | Rwanda             |
| Orange Money        | `ORANGE_MONEY_RWA` | Rwanda             |
| Credit / Debit Card | `CREDIT_CARD`      | International      |
| Dollr Wallet        | `WALLET`           | Internal transfers |

See [Payments by Market](/reference/payments-by-market) for providers, routing, and operational notes.

## Before you integrate

1. Register at [merchant.heydollr.app](https://merchant.heydollr.app) and complete verification (typically 1–72 hours).
2. Generate **Client ID** and **Client Secret** under **API Keys** (shown once — store server-side only).
3. Read [API conventions](/api-conventions) for JSON format, phone numbers, currencies, and status codes.

<Warning>
  Never expose your Client Secret in client-side code, mobile binaries, or public repositories. Call the Dollr API from your backend only.
</Warning>