Recharge Card / e-Pin
LIVEQuick Summary
Purchase recharge card e-Pins for all major Nigerian networks. Get instant PIN delivery via webhook for automated reselling and distribution. Available denominations range from ₦100 to ₦20,000.
Endpoint
Send a GET request to fetch available e-Pin denominations for a provider.
https://pairgate.com/api/v1/recharge-pins/denominations
https://pairgate.com/api/v1/test/recharge-pins/denominations
Authentication
This request requires a valid Bearer token.
| Header | Value | Description |
|---|---|---|
Authorization |
Bearer {token}
|
Your unique API authorization token |
Query Parameters
This parameter is optional. Omit to fetch all available denominations.
| Parameter | Type | Required | Description |
|---|---|---|---|
provider_id |
string | No | Provider slug (e.g. mtn, airtel, glo, 9mobile) |
Code Examples
Choose your preferred language below. Replace YOUR_API_KEY with your actual API key.
// Get Recharge Card Denominations
$response = Http::withHeaders([
'Authorization' => 'Bearer YOUR_API_KEY',
'Cache-Control' => 'no-cache',
])->get('https://pairgate.com/api/v1/recharge-pins/denominations');
$result = $response->json();
dd($result);
curl -X GET "https://pairgate.com/api/v1/recharge-pins/denominations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Cache-Control: no-cache"
const axios = require('axios');
const getDenominations = async () => {
try {
const response = await axios.get(
'https://pairgate.com/api/v1/recharge-pins/denominations',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Cache-Control': 'no-cache'
}
}
);
console.log(response.data);
} catch (error) {
console.error(error.response?.data || error.message);
}
};
getDenominations();
import requests
url = "https://pairgate.com/api/v1/recharge-pins/denominations"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Cache-Control": "no-cache"
}
try:
response = requests.get(url, headers=headers)
response.raise_for_status()
data = response.json()
print(data)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://pairgate.com/api/v1/recharge-pins/denominations"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Cache-Control", "no-cache")
.GET()
.build();
try {
HttpResponse response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
System.err.println("Error: " + e.getMessage());
}
Response Format
A successful request returns a 200 status with available e-Pin denominations.
Success Response (200)
{
"status": "success",
"data": [
{
"denomination": 100,
"currency": "NGN",
"description": "₦100 e-Pin"
},
{
"denomination": 200,
"currency": "NGN",
"description": "₦200 e-Pin"
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
denomination |
integer | e-Pin value in Naira |
currency |
string | Currency code (always NGN) |
description |
string | Human-readable description of the e-Pin |
Error Responses
The following errors may occur when calling this endpoint.
| Status | Code | Description |
|---|---|---|
| 401 | Missing API key |
No Bearer token provided |
| 401 | Invalid API key |
Token does not match any active key |
| 403 | Suspended |
API key or account has been suspended |
| 429 | Rate limited |
Too many requests |