API Reference

v2.0.0

NabooPay Payment Gateway API for West Africa. Manage transactions, payouts, and accounts via a single REST API.

Base URL

text

https://api.naboopay.com

Authentication

All endpoints require a Bearer token in the Authorization header. You can generate your API key from the NabooPay dashboard.

bash

curl https://api.naboopay.com/api/v2/transactions \
  -H "Authorization: Bearer YOUR_API_KEY"

Header	Value
`Authorization`	`Bearer YOUR_API_KEY`

Rate Limiting

All endpoints are limited to 100 requests per 60 seconds using a sliding window algorithm. Exceeding this returns a 429 Too Many Requests response.

Operation	Organization Status Required
Read — `GET`	Any (active or inactive)
Write — `POST`, `DELETE`	Organization must be active

Error Responses

All errors return a consistent JSON body with a human-readable message.

json

{
  "error": "Transaction not found"
}

v1 API is deprecated

The v1 API is no longer maintained and will not receive new features. Migrate to v2 for improved filtering, pagination, and the new Payouts API. View migration guide