POST

/api/v1/education

The Education API enables instant candidate profile validation (JAMB) and immediate generation of exam registration ePins and result checker tokens for JAMB (UTME & DE), WAEC Direct, NECO Token, and NABTEB.

🎓 Instant PIN & Serial Delivery
Structured PIN Payload: The cleartext exam PIN and optional Serial Number are returned directly in the JSON response under data.pin and data.serial for immediate display or printouts.
POST

/api/v1/education-verify

Validate JAMB 10-digit candidate Profile Code before generating UTME or Direct Entry ePINs.

Request Parameters (JSON Body)

Parameter Type Required Description
serviceID string Required Must be jamb.
billersCode string Required 10-digit JAMB candidate Profile Code (e.g., 5091829401).
type string Required utme (Unified Tertiary Matriculation Examination) or direct-entry.

Sample Verification Response

{
  "status": "success",
  "message": "Profile ID verified successfully",
  "data": {
    "Customer_Name": "CHUKWUEMEKA GODSWILL NNAMDI",
    "Profile_ID": "5091829401",
    "Exam_Type": "UTME",
    "Status": "Eligible"
  }
}
GET

/api/v1/education-variations

Fetch current examination boards and PIN variations pricing.

Query Parameters

Parameter Type Required Description
service_id string Optional waec, jamb, neco, nabteb.

Purchase Education PIN Endpoint (POST)

Parameter Type Required Description & Example
serviceID string Required Exam board: waec, jamb, neco, nabteb.
amount numeric Required Amount in Naira (e.g. 3800).
phone string Required Recipient's 11-digit mobile number for PIN delivery.
billersCode string Optional Candidate Profile ID (for JAMB) or omitted (handled internally).
variation_code string Optional ePin plan code: resolved automatically by default (waecdirect, neco, etc.).
request_id string Optional Unique merchant client tracking reference.

Integration Code Examples

curl -X POST "https://tente.com.ng/api/v1/education" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "serviceID": "waec",
    "amount": 3800,
    "phone": "08031234567",
    "request_id": "REQ_EDU_99120"
  }'
const response = await fetch("https://tente.com.ng/api/v1/education", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    serviceID: "waec",
    amount: 3800,
    phone: "08031234567",
    request_id: "REQ_EDU_" + Date.now()
  })
});

const result = await response.json();
console.log(result);
<?php

$client = new \GuzzleHttp\Client();

$response = $client->post('https://tente.com.ng/api/v1/education', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_TOKEN',
        'Content-Type'  => 'application/json',
        'Accept'        => 'application/json',
    ],
    'json' => [
        'serviceID'  => 'waec',
        'amount'     => 3800,
        'phone'      => '08031234567',
        'request_id' => 'REQ_EDU_' . uniqid(),
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
import requests

url = "https://tente.com.ng/api/v1/education"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "serviceID": "waec",
    "amount": 3800,
    "phone": "08031234567",
    "request_id": "REQ_EDU_123456"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Sample 200 OK Success Response (With PIN & Serial)

{
  "status": "success",
  "message": "WAEC PIN purchase successful.",
  "data": {
    "transaction_ref": "EDU2026083114300188AB",
    "request_id": "REQ_EDU_99120",
    "service_id": "waec",
    "provider_name": "WAEC Result Checker PIN",
    "pin": "098765432112",
    "serial": "WRN123456790",
    "cards": [
      {
        "Serial": "WRN123456790",
        "Pin": "098765432112"
      }
    ],
    "tokens": [],
    "purchased_code": "Serial No:WRN123456790, pin: 098765432112",
    "variation_code": "waecdirect",
    "amount": 3800.00,
    "phone": "08031234567",
    "type": "Education PIN Purchase",
    "bonus_earned": 50.00,
    "new_balance": 33451.50,
    "status": "completed",
    "created_at": "2026-08-31T14:30:01+01:00"
  }
}

Error Responses

422 Invalid Profile ID

{
  "status": "error",
  "message": "Unable to verify candidate profile ID."
}

402 Insufficient Balance

{
  "status": "error",
  "message": "Insufficient wallet balance."
}