HTTP status codes

The RESTful architecture of Affinity's API utilizes standard HTTP response codes to indicate the success or failure of requests

HTTP code	Description
`200`	Request was successful. Please note that for all transaction requests, a `200` status code will be returned. To determine the success or failure of the transaction, you should examine the data object for the transaction status.
`400`	Client Error. There may be an issue with the request. Please check the request parameters and ensure they are correct.
`422`	Validation error
`401`	Unauthorized. This error occurs when the `x-api-key` is missing or the provided API key is invalid.
`404`	Requested resource does not exist
`500`	An error occurred on Affinity's side. This issue is not expected. Please contact support if you encounter this error.

Transaction status codes

Affinity uses transaction status codes to indicate the current state of a transaction

Transaction Status Code	Description
`00`	Transaction successful
`01`	Transaction failed
`03`	Transaction is being processed

Last modified: 27 August 2025