Docs
DocsAPI RestRecipesTutorialsHelp

Card Verification

Argentina
Brazil
Caribbean
Colombia
Mexico
Panama
Uruguay

🚧

Important

Only to be used in regions where PSD2 is not mandatory

Use the Card Verification service to check a card is available for charging before a customer uses it to pay.

A card verification lookup will perform a zero value authorization against the card to ensure it is not fraudulent, blacklisted, expired or blocked. Essentially it lets you check whether the card and account are in good standing and available to make payment.

Submit a payload containing the card details, such as in the example below, using a POST method to the /card-verification endpoint:

{
  "paymentCard": {
    "number": "4035874000424977",
    "expiryDate": {
      "month": "12",
      "year": "20"
    },
    "securityCode": "977"
  },
  "billingAddress": {
    "address1": "5565 Glenridge Conn",
    "city": "Atlanta",
    "postalCode": "30342",
    "country": "USA"
  }
}

{
    "clientRequestId": "abe60a9a-68d9-481b-9231-f4249dc780f6",
    "apiTraceId": "Y5x91LTuBgbtsqfXWEr1EAAAAmM",
    "ipgTransactionId": "84614660926",
    "orderId": "R-451b2caf-057e-40ba-a6f5-6d867faf7aee",
    "transactionType": "PREAUTH",
    "paymentToken": {
        "reusable": true,
        "declineDuplicates": false,
        "brand": "VISA",
        "type": "PAYMENT_CARD"
    },
    "transactionOrigin": "ECOM",
    "paymentMethodDetails": {
        "paymentCard": {
            "expiryDate": {
                "month": "12",
                "year": "2020"
            },
            "bin": "403587",
            "last4": "4977",
            "brand": "VISA"
        },
        "paymentMethodType": "PAYMENT_CARD"
    },
    "country": "Germany",
    "terminalId": "RC103954",
    "merchantId": "881111110000228",
    "transactionTime": 1671200212,
    "approvedAmount": {
        "total": 0.00,
        "currency": "GBP",
        "components": {}
    },
    "transactionStatus": "APPROVED",
    "approvalCode": "Y:172781:4614660926:PPX :832080",
    "schemeTransactionId": "732166657640953",
    "processor": {
        "referenceNumber": "084614660926",
        "authorizationCode": "172781",
        "responseCode": "00",
        "responseMessage": "Function performed error-free",
        "avsResponse": {
            "streetMatch": "NO_INPUT_DATA",
            "postalCodeMatch": "NO_INPUT_DATA"
        }
    }
}

📘

Note

In he above example response, the transactionStatus as APPROVED, which confirms the card details are ok to be used in a future transaction

Updated 13 days ago