Result Checker
Get Result Checker Order Status
Return the status of one result-checker transaction owned by the caller.
Endpoint
GET /api/v1/result-checker/orders/{orderId}/status
Path parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
orderId | rcTransactions id | Yes | Result checker transaction id |
Response
Returns the transaction status with credential if completed:
{
"success": true,
"data": {
"_id": "rc9exampletxn",
"shortReference": "421903",
"state": "completed",
"paymentGatewayStatus": null,
"amount": 5.00,
"currency": "GHS",
"packageName": "Result Checker - Basic",
"buyerPhone": "233201234567",
"credential": {
"username": "candidate-user",
"password": "candidate-pass"
},
"createdAt": 1234567890123,
"completedAt": 1234567950000
}
}Response fields
| Field | Type | Notes |
|---|---|---|
_id | string | rcTransactions record ID |
shortReference | string | Short alphanumeric reference |
state | string | pending, completed, or failed |
paymentGatewayStatus | string | null | Gateway status (if payment gateway was used) |
amount | number | GHS amount charged |
currency | string | Always GHS |
packageName | string | Package name |
buyerPhone | string | Recipient phone number |
credential | object | null | Only present when state is completed |
createdAt | number | Creation timestamp (unix ms) |
completedAt | number | null | Completion timestamp (unix ms) |
Credential object (when present)
| Field | Type | Notes |
|---|---|---|
username | string | Login username |
password | string | Login password |
Errors
404- Transaction not found or unauthorized403- Insufficient permissions
Sample request
curl -X GET "https://api.netconnectgh.online/api/v1/result-checker/orders/rc9exampletxn/status" \
-H "X-API-KEY: netconnect_live_your_secret_here" \
-H "Content-Type: application/json"