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.
Quick Start
First collection in under 10 minutes — invoice flow with cURL, Python, and Node.js.
Build with AI
Agentic development — AI assistants, MCP, prompts, and guardrails for Dollr.
Choose your integration
Invoice, checkout shortcut, payout, or realtime — pick the right path.
Authentication
OAuth 2.0 client credentials, token refresh, and API keys from the merchant portal.
Integrate by stack
Node.js
Server-side JavaScript with
fetch.Python
Invoice collection with
requests.Django
Service layer +
requests in Django.Ruby
Invoice collection with Net::HTTP.
PHP
cURL or Guzzle from PHP 8.1+.
Java
HttpClient and JSON on the JVM.Go
net/http and encoding/json.Rust
reqwest + serde async client..NET
C#
HttpClient and System.Text.Json.Next.js
Route Handlers and Server Actions.
Laravel
Laravel HTTP client and config.
Hosted checkout
Customer pays with mobile money or card on a Dollr-hosted page.
Payout with Node.js
Send mobile-money payouts from Node.js.
Direct checkout
One call to create source + session — skip manual party/invoice steps.
Integration guide
Full collection and payout walkthroughs.
Explore
Payments by market
MTN, Orange, Airtel, cards — methods and providers by country.
Sessions & executions
How checkout sessions, idempotent executions, and status polling work.
Error catalog
Common API errors, causes, and fixes.
API Reference
Interactive OpenAPI docs — try every endpoint in the browser.
AI & MCP
llms.txt, docs MCP URL, and LLM integration guardrails.
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 |
Before you integrate
- Register at merchant.heydollr.app and complete verification (typically 1–72 hours).
- Generate Client ID and Client Secret under API Keys (shown once — store server-side only).
- Read API conventions for JSON format, phone numbers, currencies, and status codes.
