Error Codes

HTTP Status Codes

The API returns appropriate HTTP status codes for every request.
Code Text Description
200 OK Success - The request completed successfully.
400 Bad Request The request was invalid or cannot be otherwise served.
401 Unauthorized Authentication failed or user does not have permissions.
403 Forbidden The request is understood but access is not allowed.
404 Not Found The requested resource was not found.
409 Conflict Duplicate Transaction - the transaction has already been processed.
422 Unprocessable Entity Invalid OTP - the provided OTP is incorrect or expired.
429 Too Many Requests Too many attempts - retry limit exceeded for OTP verification.
500 Internal Server Error An unexpected error occurred on the server.
Business Error Codes

Description of business-specific error scenarios.
Scenario HTTP Code Response Message
Invalid unique code 400 Invalid or already redeemed code
Code already used 409 Code already redeemed
Invalid OTP 422 Invalid OTP
OTP expired 422 OTP has expired. Please request a new one.
Max OTP attempts exceeded 429 Too many attempts. Please try again later.
Insufficient wallet balance 400 Insufficient wallet balance for this redemption
Product not available 404 Requested product is not available