Response codes
HTTP response reference
HTTP status codes are three-digit numbers that indicate the outcome of a request. In the case of an error response, the status code falls within the range of 4xx or 5xx. By taking into account HTTP code and ID, you can perform exemption or error handling.
The Worldline Connect API uses the following HTTP response codes:
- 2xx means your request was handled successfully
- 4xx means that we couldn't process your request either due to the incorrect request or because the transaction doesn't have the correct status for your action
- 5xx means something went wrong in our system
| Code | Status message | Description |
|---|---|---|
| 200 | Successful | Your request was processed correctly. |
| 201 | Created | Your request was processed correctly, and a new resource was created. The URI of this created resource is returned in the Location header of the response. |
| 400 | Bad request | Your request is incorrect and can’t be processed. Please correct the mistake and try again. |
| 402 | Request Failed | It's valid data, but the request got rejected for a certain reason and needs investigation. |
| 403 | Not Authorized | You’re trying to do something that isn't allowed or that you’re not authorized to do. |
| 404 | Not Found | The object you were trying to access couldn't be found on the server. |
| 405 | Method Not Allowed | The action you are attempting to do isn't allowed. For example, trying to refund a payment 90 days after authorization. |
| 410 | Gone | The object that you are trying to reach has been removed. |
| 500 | Internal Server Error | Something went wrong on our end. |
| 502 | Bad Gateway | We were unable to process a message from a downstream partner/acquirer. |
| 503 | Service Unavailable | The service that you’re trying to reach is temporarily unavailable. Please try again later. |
| 504 | Gateway Timeout | The server, while acting as a gateway or proxy, didn't receive a timely response from an upstream server it needed to access for completing the request. |