Error Code List

This is a list of error codes that Online Bespoke API calls may return.

Status Code

Example Error

Resolution

200 OK

Order initiated successfully

No action needed

400 Bad Request

Unsupported Currency or Invalid parameters, missing fields

Validate request payload before sending; correct parameter formats

401 Unauthorized

Invalid/expired token

Refresh/reauthenticate using a valid token or validate credentials

404 Not Found

Order not found

Confirm the API endpoint, order context token, and ensure the order exists

409 Conflict

Duplicate refund request

Use a proper idempotency key; avoid resending the same request as new

412 Precondition Failed

Provided token is invalid or expired, rejected, invalid order status

Confirm API URL, or For refund APIs, check refund amount or order status

500 Internal Server Error

Generic server failure

Retry using exponential backoff

502/503/504

Gateway timeout / service unavailable

Retry using exponential backoff