Result Checker
Buy Single Result Checker Package
Deduct wallet balance and assign one available credential to a recipient.
Endpoint
POST /api/v1/result-checker/buy-single
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
packageId | rcPackages id | Yes | Result checker package |
recipientPhone | string | Yes | Destination phone number |
Business rules
- restricted to
AgentandSuperAgent - debits wallet balance before assigning inventory
- refunds the wallet if inventory is unavailable after the debit attempt
- returns the assigned credential directly in the success payload
Response
Returns the transaction with assigned credential:
{
"success": true,
"data": {
"transactionId": "rc9exampletxn",
"shortReference": "421903",
"credential": {
"username": "candidate-user",
"password": "candidate-pass"
}
}
}Response fields
| Field | Type | Notes |
|---|---|---|
transactionId | string | rcTransactions record ID |
shortReference | string | User-friendly alphanumeric reference |
credential | object | Login credentials assigned to recipient |
Credential object
| Field | Type | Notes |
|---|---|---|
username | string | Login username |
password | string | Login password |
Errors
403- Only Agent and SuperAgent can purchase402- Insufficient wallet balance400- Invalid request parameters
Sample request
curl -X POST "https://api.netconnectgh.online/api/v1/result-checker/buy-single" \
-H "X-API-KEY: netconnect_live_your_secret_here" \
-H "Content-Type: application/json" \
-d '{
"packageId": "rcpkgexample123",
"recipientPhone": "233201234567"
}'