All VisaNet Connect APIs use conventional HTTP response codes to indicate the success or failure of an API request. The HTTP status code 200 is returned for a successful API call. Other HTTP status codes, such as 4xx and 5xx, are returned for unsuccessful calls.
To determine the status of any API call, use the combination of the HTTP status code returned in the response, error code from the Visa platform and other information included in the response message in order to apply the correct processing logic and communicate with customers.
The following table provides additional guidance on how to interpret and act upon status responses returned by Visa for inbound API messages. Additional information on error codes for outbound messages where the issuer responds to Visa can be shared by the product office.
| HTTP Status Code | Error Code | Error Description |
|---|---|---|
| 200 | None | API request processed successfully. |
| 400 | Various | The message had validation errors due to invalid field lengths, data type, or missing fields. |
| 401 | None | The API request is returned if user's credentials are invalid. Authentication failure. |
| 402 | Various | API request failed due to a processing error. |
| 403 | None | The URL access is not permitted. Contact your Visa production support contact for assistance. |
| 404 | None | The URL is invalid or the Resource could not be found. |
| 406 | None | Invalid request format. Missing a required field, or field is incorrect length. |
| 500 | None | An internal server error occured. Contact your Visa production support contact for assistance. |
| 503 | None | Service unavailable. Contact your Visa production support contact for assistance. |
| 504 | None | Timeout due to a processing issue or a network connectivity issue. Contact your Visa production support contact for assistance. |
Start a Project
API Overview
API Reference