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.