Recharge Card / e-Pin

LIVE
Endpoint

Send a GET request to fetch available e-Pin denominations for a provider.

Production URL
https://pairgate.com/api/v1/recharge-pins/denominations
Method GET
Test Endpoint
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.

PHP (Laravel)
// 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
curl -X GET "https://pairgate.com/api/v1/recharge-pins/denominations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Cache-Control: no-cache"
Node.js
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();
Python
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}")
Java
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