NetConnect API Docs

Endpoint

POST /api/v1/data-bundles/buy-single

Request body

Field	Type	Required	Notes
`packageId`	`packages` id	Yes	Selected package
`productId`	`products` id	Yes	Parent product
`operatorId`	`operators` id	Yes	Parent operator
`beneficiaryMsisdn`	string	Yes	Recipient phone number
`paymentReference`	string	No	Optional offline-first reference
`anonymousId`	string	No	Present in shared schema but not typically used in API-key flows

Behavior

validates operator, product, and package consistency
normalizes the beneficiary number
checks for blocking in-flight orders on the same number
applies role-aware pricing
checks wallet balance for agents and super agents
creates and submits an order through the shared internal purchase flow

Response

On success, returns result object:

{
  "success": true,
  "data": {
    "success": true,
    "orderId": "kr7...",
    "shortReference": "128304",
    "message": "Data bundle purchase submitted successfully",
    "amountCharged": 12.5,
    "status": "processing",
    "walletBalanceBefore": 250.00,
    "walletBalanceAfter": 237.50
  }
}

Response fields

Field	Type	Notes
`success`	boolean	Always `true` on success
`orderId`	string	Order database ID
`shortReference`	string	Short alphanumeric order reference for user-friendly sharing
`message`	string	Success message
`amountCharged`	number	GHS amount deducted from wallet
`status`	string	Initial order status — `"processing"` for data bundle purchases. Use the order status endpoint to track progression to `completed` or `failed`.
`walletBalanceBefore`	number	Wallet GHS balance immediately before this order was charged
`walletBalanceAfter`	number	Wallet GHS balance after this order was charged (`before - amountCharged`)

Errors

Possible errors:

403 - Invalid API key or insufficient permissions
400 - Invalid request parameters or validation failed
402 - Insufficient wallet balance
409 - Duplicate order detected or conflicting in-flight order

Sample request

POST/api/v1/data-bundles/buy-singletry·it·live

request body · json

✓ valid

⚠ no api key set — request will use placeholder

curl -X POST "https://api.netconnectgh.online/api/v1/data-bundles/buy-single" \
  -H "X-API-KEY: netconnect_live_your_secret_here" \
  -H "Content-Type: application/json" \
  -d '{
  "operatorId": "k57exampleoperator",
  "productId": "p22exampleproduct",
  "packageId": "q34examplepackage",
  "beneficiaryMsisdn": "233201234567"
}'

Buy Single Data Bundle