Skip to main content

Status Codes

Tupay uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with Tupay's servers (these are rare).

    200 - OK
    400 - Bad Request
    401 - Unauthorized
    402 - Request Failed
    403 - Forbidden
    404 - Not Found
    409 - Conflict
    429 - Too Many Requests
    500, 502, 503, 504 - Server Errors

There are also custom transactional status codes to allow you better understand the status of your transaction. These are returned in the response body.

Successful​

    20 - Success

Pending​

    0 - Created
    3 - Submitted
    31 - Processing
    100, 101 - Retrying

Failed​

    1 - Cancelled
    2 - Failed
    5 - Invalid
    6 - Timeout
    7 - Insufficient
    8 - Reversed
    9 - Refunded
    10 - Forbidden
    11, 120 - Rejected
    13, 15, 16, 24 - Errors
    17 - Duplicate
    18 - Expired
    19 - Inactive