> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapidtopup.com.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Base URL & Versioning

> The base URL for all B2B API endpoints, the current v2 version and its URL prefix, and the versioning policy for breaking changes and deprecation notices.

## Base URL

```
https://api.rapidtopup.com.ng/api/v2/b2b
```

All endpoints in this reference are **relative to this base URL**.

***

## Live vs. Sandbox (Test) Environments

RapidTopup uses the **same base URL** for both Live and Sandbox requests. The environment is determined entirely by the API key provided in the `Authorization` header:

| Environment | Key Format | Description |
| - | - | - |
| **Live** | `rtu_live_sk_...` | Deducts real wallet balance and routes to live telco/utility providers. |
| **Sandbox (Test)** | `rtu_test_sk_...` | Routes requests to the isolated mock sandbox environment. Deducts from your simulated test balance (starting at ₦500,000.00) and supports test phone scenarios without spending real funds. |

***

## Current Version

| Field | Value |
| - | - |
| Version | `v2` |
| Status | **Live / Stable** |
| Full prefix | `/api/v2/b2b` |

***

## Versioning Policy

* The API version is embedded in the URL path (`/api/**v2**/b2b`)
* **Breaking changes** (removed fields, changed behavior) are released under a new version (e.g. `/api/v3/b2b`)
* Older versions receive a **90-day deprecation notice** before retirement
* **Non-breaking additions** (new optional fields, new endpoints) are added to the current version without a bump

> [!NOTE]
>
> Subscribe to our developer announcements at [support@rapidtopup.com.ng](mailto:support@rapidtopup.com.ng) to be notified of any upcoming version changes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.