JSON example POST
If a request is successful, you will receive an HTTP 200 status code along with a JSON response body. The contents of the JSON response body will differ depending on the transaction, please refer to the detailed explanation in this document for details. Here is a sample response for a common transaction, consumer inquiry (POST /Retail):
{
"merchantID": "123456",
"accounts": {
"micrData": "t123456780t o1234455778o 1234",
"swipeInd": "true",
},
"name": {
"firstName": 'First'
",
"lastName": "Last",
},
"dob": "yyyy-MM-DD",
"address": {
"address1": "1111 address st ",
"address2": " ",
"city": "Marietta",
"state": "GA",
"zip": "30006",
},
"id": {
"idState": "GA",
"idValue": "1234567780",
},
"totalAmount": "19.95",
"phoneNumber": "727-555-1212",
"trxID": "12452154-aa-BB",
"integratorID": "12452154-aa-BB",
}
JSON Response
If a request is successful, you will receive an HTTP 200 status code along with a JSON response body (see above description). If a request is not successful, you will receive a non-200 status code (see list above).
{
"trxID": "1054848488",
"trxRefID": "0000000000193",
"achRefID": "323232323",
"approvalNum": "179972",
"aba": "123456780",
"accountLast4": "5778",
"checkType": "P",
"checkNum": "1234"
}
HTTP status in the 4xx or 5xx range will normally return a JSON response body that contains an array of errors when the adverse action is true a decline might represent an Adverse Action.
- A reference number that can be printed on the decline receipt or otherwise provided to the consumer if they choose to contact Certegy Payment Solutions. LLC for additional information.
- A station number, which uniquely identifies both the product and the merchant for use when contacting Certegy support.
- A “Customer Care” phone number, which can be provided to the consumer if they choose to contact Certegy for additional information.
{
"errors": [{
"errorPath": "/check/retail",
"errorMessage": "Invalid Identification Number",
"errorDetails": "The ID presented does not conform to known ID formats. Validate the identification before re-entering.",
"errorType": "id_error",
"errorDate": "2020-04-21T17:37:06.418Z",
"trxID": "1054848488",
"trxRefID": "5000000000004",
"responseCode": "0100",
"adverseAction": false,
"stationNum": "1055029606"
}]
}