NahuPay Developer Docs

Welcome to the NahuPay API documentation. NahuPay provides payment infrastructure for Ethiopian businesses — accept TeleBirr, M-Pesa, CBE Birr, and bank transfers through a single unified API.

✓Sandbox environment — all API keys prefixed with test_ operate in sandbox mode. No real money moves. Use live_ keys for production.

⚡

Quickstart

Make your first API call in under 5 minutes.

📖

API Reference

Full reference for every endpoint, parameter, and response.

📦

SDKs

Official libraries for Node.js, Python, PHP, and Java.

🪝

Webhooks

Receive real-time events when payments succeed or fail.

Base URL

All API requests are made to:

https://api.nahupay.com/v1

Authentication

NahuPay uses API keys to authenticate requests. Include your key in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY

You can find and rotate your API keys in the dashboard. Never share your live_ keys in client-side code.

Payment methods

NahuPay supports the following payment methods out of the box:

Method	Identifier	Coverage
TeleBirr	`telebirr`	40M+ users nationwide
M-Pesa	`mpesa`	Major cities (waitlist)
CBE Birr	`cbe_birr`	CBE account holders
Bank transfer	`bank_transfer`	Any Ethiopian bank

API versioning

The current stable API version is v1. API v2 is in public beta — see the changelog for details. Breaking changes are never made to a stable version; when they're necessary a new version is released and the old one is supported for at least 12 months.

Rate limits

Plan	Requests / minute	Requests / day
Starter	60	10,000
Growth	300	100,000
Enterprise	Custom	Unlimited

When you exceed a rate limit the API responds with 429 Too Many Requests and includes a Retry-After header indicating how many seconds to wait.