Verify Cable TV Customer

LIVE
Endpoint

Send a POST request with the provider and smartcard details in the request body.

Production URL
https://pairgate.com/api/v1/cable/verify
Method POST
Test Endpoint
https://pairgate.com/api/v1/test/cable/verify
Authentication

This request requires a valid Bearer token.

Header Value Description
Authorization
Bearer {token}
Your unique API authorization token
Content-Type
application/json
Required for POST requests
Body Parameters

Both parameters are required. Send them as JSON in the request body.

Parameter Type Required Description
provider_id string Yes Provider slug (e.g. dstv, gotv, startimes)
smartcard string Yes Smartcard / IUC number
Code Examples

Choose your preferred language below. Replace the parameters and YOUR_API_KEY with your actual values.

PHP (Laravel) 
// Verify Cable TV Customer
$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_API_KEY',
    'Content-Type' => 'application/json',
])->post('https://pairgate.com/api/v1/cable/verify', [
    'provider_id' => 'dstv',
    'smartcard' => '1234567890',
]);

$result = $response->json();

dd($result);
cURL 
curl -X POST "https://pairgate.com/api/v1/cable/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_id": "dstv",
    "smartcard": "1234567890"
  }'
Node.js 
const axios = require('axios');

const verifyCableCustomer = async () => {
    try {
        const response = await axios.post(
            'https://pairgate.com/api/v1/cable/verify',
            {
                provider_id: 'dstv',
                smartcard: '1234567890'
            },
            {
                headers: {
                    'Authorization': 'Bearer YOUR_API_KEY',
                    'Content-Type': 'application/json'
                }
            }
        );
        
        console.log(response.data);
    } catch (error) {
        console.error(error.response?.data || error.message);
    }
};

verifyCableCustomer();
Python 
import requests
import json

url = "https://pairgate.com/api/v1/cable/verify"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "provider_id": "dstv",
    "smartcard": "1234567890"
}

try:
    response = requests.post(url, headers=headers, json=payload)
    response.raise_for_status()
    data = response.json()
    print(json.dumps(data, indent=2))
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();

String jsonBody = "{"
    + "\"provider_id\": \"dstv\","
    + "\"smartcard\": \"1234567890\""
    + "}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://pairgate.com/api/v1/cable/verify"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

try {
    HttpResponse response = client.send(request, 
        HttpResponse.BodyHandlers.ofString());
    
    System.out.println(response.body());
} catch (Exception e) {
    System.err.println("Error: " + e.getMessage());
}
Example Request Body
{
  "provider_id": "dstv",
  "smartcard": "1234567890"
}
Response Format
Success Response (200) 
{
  "code": 200,
  "status": "success",
  "data": {
    "status": true,
    "customer_name": "John Doe"
  }
}
Test Response (200) 
{
  "code": 200,
  "status": "success",
  "data": {
    "test_mode": true,
    "message": "This is a test — no API call made.",
    "status": true,
    "customer_name": "Test Customer (Sandbox)"
  }
}
Response Fields
Field Type Description
status boolean true if the smartcard is valid
customer_name string Name registered on the smartcard
Error Responses

The following errors may occur when calling this endpoint.

Status Code Description
422 Invalid provider Provider not found or inactive
500 No active package No cable package available for verification
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