Response codes
Payment Links uses HTTP status codes to signify the success or failure of an API request.
Codes in the 2xx range mean success and codes in the 4xx range mean error or failure. Examples of issues that could cause a 4xx range failure include:
- A required parameter was omitted
- A charge failed
HTTP status codes
Response code | Status | Description |
---|---|---|
200 | OK | Request processed. |
400 | Bad request | Request failed due to missing or invalid parameters being supplied. Also returned if the payment failed, for example, if the acquirer declined the transaction. |
401 | Unauthorised | Incorrect authentication information, for example, one of the authentication parameters is wrong - check them or contact us for correct parameters. |
404 | Not found | The requested resource or endpoint cannot be found, that is, the endpoint or URL does not exist. Check that you have entered the correct endpoint. |
Although not all error codes are mapped, an error object is included when a failed payment link request occurs. This error object explains why the request failed.
Result codes
Payment Links
All Payment Links result codes start with 1000
.
Bulk Payment Links
The API returns an error code in the errorCode
parameter of the batch link status response body if the status is error
.
All Bulk Payment Links result codes feature 100
after the first period.
Result code | Description |
---|---|
1000.100.000 | Processing of the file has failed. |
1000.100.010 | Channel not found |
1000.100.020 | Unable to update batch status to 'processing' |
1000.100.101 | Invalid file format |
1000.100.102 | Empty file uploaded |
1000.100.103 | File contained 0 rows. |
1000.100.104 | File size is too large. Please submit a smaller file. |
1000.100.105 | File contains too many rows. |
Updated 7 months ago