Purchase exam scratch cards and result-checker PINs
Overview
The education PIN endpoint lets you purchase result-checker and exam registration scratch cards (WAEC, NECO, JAMB, etc.) in bulk or one at a time.Fetch exam product names from Get products (service=EXAM PIN or the matching service name from your catalog), then call purchase directly.
Authentication
Requires your merchant API key and the channel: API header.
Authorization: Bearer dcy_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxchannel: API
1. GET /api/v1/products?service=EXAM PIN → pick exam_name and note unit price2. POST /api/v1/education-pin/purchase { exam_name, quantity } → receive PIN details in the transaction response
Education PINs are delivered immediately. Store them securely — they cannot be re-fetched from the API after the transaction response is received.