API Errors & Status Codes

Vixzz returns standard HTTP status codes combined with structured JSON error objects for deterministic handling.

Error CodeHTTPDescription
invalid_client401Consumer Key or Secret is incorrect or expired.
invalid_otp400The 6-digit OTP code submitted was incorrect.
otp_expired400The 6-digit OTP code expired (valid for 300 seconds).
invalid_encrypted_pin401Developer RSA-2048 encrypted transaction PIN failed decryption or was incorrect.
account_not_found404The 13-digit account number starting with 38 does not exist.
insufficient_funds400Wallet available balance below payout amount plus fees.
idempotency_conflict409Idempotency key was submitted with different body.
rate_limited429Too 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"
}