Skip to main content

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

MethodIdentifierMarket
MTN Mobile MoneyMTN_MOMO_LBRLiberia
Orange MoneyORANGE_MONEY_LBRLiberia
Airtel MoneyAIRTEL_RWARwanda
MTN Mobile MoneyMTN_MOMO_RWARwanda
Orange MoneyORANGE_MONEY_RWARwanda
Credit / Debit CardCREDIT_CARDInternational
Dollr WalletWALLETInternal transfers
See Payments by Market for providers, routing, and operational notes.

Before you integrate

  1. Register at 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 for JSON format, phone numbers, currencies, and status codes.
Never expose your Client Secret in client-side code, mobile binaries, or public repositories. Call the Dollr API from your backend only.
Last modified on June 23, 2026