Shell Python Node.js Java PHP
« Go to main menu

REST API errors

Example of statuses and errors returned by the POST Pricing/Acquiring API endpoint:

200 - OK

401 - Unauthorized (Wrong Consumer/Auth Header)

400 - Bad Request (Incorrect Cart Products) see response body below

  "message": "Missing Equipment Products" 

First Data returns standard HTTP status codes for successful and error responses. Please see the table below for detail on statuses used across all First Data Marketplace APIs.

Code Description Meaning, more information
200 OK The request has succeeded.
400 Bad Request Validation error, the server cannot or will not process the request due to something that is perceived to be a client error i.e.: request parameters/body does not have required or correct inputs.
401 Unauthorized Authentication error due to invalid HMAC. Ensure that the access token is valid and present and not expired. See our Authentication section for detail.
403 Forbidden The consumer is not authorized to access this API.
404 Not found Incorrect API URI, resource cannot be found.
409 Conflict The request could not be completed due to a conflict with the current state of the target resource. i.e.: If duplicate record exists.
500 Internal Server Error First Data server down/not responding.
502 Bad Gateway The server, while acting as a gateway or proxy, received an invalid response from an inbound server.