Error Handling
Error Response Schema
- All error responses follow the ErrorResponse schema.
- Standard HTTP status codes are used.
Common Error Codes
Unauthorized (401)
Invalid or missing app-id or api-key credentials.
Example
{
"error": {
"status": "FAILED",
"status_code": "401",
"message": "UNAUTHORIZED",
"detail": "Invalid app-id or api-key"
}
}Duplicate Trace Number (439)
The trace_number must be unique per transaction.
Example
{
"error": {
"status": "FAILED",
"status_code": "439",
"message": "TRACE_NUMBER",
"detail": "trace_number must be unique"
}
}Unauthorized IP Access (479)
Returned when the request originates from an IP address not whitelisted in Account Management → Generate API Key. Configure your server IPs to use the API.
Example
{
"error": {
"status": "FAILED",
"status_code": "479",
"message": "UNAUTHORIZED_IP_ACCESS",
"detail": "Unauthorized IP address access."
}
}