API Errors & Status Codes
Vixzz returns standard HTTP status codes combined with structured JSON error objects for deterministic handling.
| Error Code | HTTP | Description |
|---|---|---|
invalid_client | 401 | Consumer Key or Secret is incorrect or expired. |
invalid_otp | 400 | The 6-digit OTP code submitted was incorrect. |
otp_expired | 400 | The 6-digit OTP code expired (valid for 300 seconds). |
invalid_encrypted_pin | 401 | Developer RSA-2048 encrypted transaction PIN failed decryption or was incorrect. |
account_not_found | 404 | The 13-digit account number starting with 38 does not exist. |
insufficient_funds | 400 | Wallet available balance below payout amount plus fees. |
idempotency_conflict | 409 | Idempotency key was submitted with different body. |
rate_limited | 429 | Too many requests. Back off and retry. |
Request Code Snippets (cURL, Node, Python, PHP, Go)
JSON Return Response Body (200 OK)
Standard Error Response
{
"error_code": "insufficient_funds",
"message": "Your business wallet balance is below the requested payout amount plus fees.",
"param": "amount",
"doc_url": "https://developer.vixzz.com/docs/errors#insufficient_funds"
}