Error Codes

All error responses follow the same structure:

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Your wallet balance is too low for this purchase."
  }
}

Code	HTTP Status	Description
`VALIDATION_ERROR`	422	Missing or invalid request parameters. Check the `details` field.
`UNAUTHORIZED`	401	Missing or invalid API key / secret.
`INVALID_ENVIRONMENT`	400	`X-Environment` header must be `test` or `live`.
`MISSING_PACKAGE`	400	A package code is required (data or cable TV).
`MISSING_AMOUNT`	400	Amount required for airtime or electricity.
`INVALID_PACKAGE`	400	The provided `package_code` does not exist.
`INSUFFICIENT_FUNDS`	400	Your wallet balance is too low.
`DUPLICATE_REFERENCE`	409	The `reference` you supplied has already been used.
`GATEWAY_ERROR`	400	The payment gateway returned an error. Try again later.
`INTERNAL_ERROR`	500	An unexpected error occurred. Contact support.