API Reference

Error Codes

This section provides a list of error codes that may be encountered when interacting with the Trident APIs (Analyze API, Update Transaction Status API, and Combined Analyze and Update API).

HTTP Status Codes

Error CodeDescription
200Success - The request was processed successfully.
400Validation Error - Missing or invalid fields in the request.
500Internal Server Error - An unexpected error occurred on the server.
503Service Unavailable - Timeout during request processing.

Transaction Error Codes

Error CodeDescription
104OTP could not be generated.
074Request timed out at ACS (Access Control Server).

Common error scenarios

Mandatory fields missing

{
  "status": "ERROR",
  "code": "400",
  "message": "Mandatory field 'instanceId' is missing",
  "timestamp": "2023-10-15T12:34:56Z",
  "traceId": "trace-123456789"
}

Invalid credentials

{
  "status": "ERROR",
  "code": "401",
  "message": "Unauthorized access. Invalid credentials provided.",
  "timestamp": "2023-10-15T12:34:56Z",
  "traceId": "trace-123456789"
}

Server error

{
  "status": "ERROR",
  "code": "500",
  "message": "An unexpected error occurred. Please try again later.",
  "timestamp": "2023-10-15T12:34:56Z",
  "traceId": "trace-123456789"
}