Query a previous verification

Request

Querying of a successful verification.

Security

BasicAuth

Path

linkDatastringrequired

Action link that's received in your request.

Acceptstringrequired

Example:application/vnd.worldpay.cardVerifications-v6+json

Content-Typestringrequired

Example:application/vnd.worldpay.cardVerifications-v6+json

curl -i -X GET \
  -u '<username>:<password>' \
  'https://try.access.worldpay.com/cardVerifications/{linkData}' \
  -H 'Accept: application/vnd.worldpay.cardVerifications-v6+json' \
  -H 'Content-Type: application/vnd.worldpay.cardVerifications-v6+json'

Responses

Successful query request

Headers

WP-CorrelationIdstring

Generated identifier for the request and response. When contacting support please include this.

Example:"4c195ce9-3dbd-4bc8-9c94-3d3393842323"

Bodyapplication/vnd.worldpay.cardVerifications-v6+json

outcomestringrequired

Result of the Card Verification

Enum:"verified""not verified"

schemeobject

Card issuer's scheme (not all issuers return this)

checkedAtstring^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{...required

Example:"2024-03-26T19:38:29.543195Z"

refusalCodestring

The refusal response code from the acquirer

Example:"6"

refusalDescriptionstring

The description of the 'refusalCode'

Example:"Try another card"

adviceobject

The MAC (Merchant Advice Code) returned by Mastercard

riskFactorsArray of objects

List of risks involved in this verification.

Example:

[
  {
    "type": "cvc",
    "risk": "notSupplied"
  },
  {
    "type": "avs",
    "detail": "postcode",
    "risk": "notSupplied"
  },
  {
    "type": "avs",
    "detail": "address",
    "risk": "notSupplied"
  }
]

paymentInstrumentobject

_linksobjectrequired

Example:

{
  "cardVerifications:verification": {
    "href": "https://try.access.worldpay.com/cardVerifications/linkData"
  }
}

Response

Querying of a successful verification for oneTime

{
  "outcome": "verified",
  "checkedAt": "2018-09-01T10:37:36.923Z",
  "riskFactors": [
    {
      "risk": "matched",
      "type": "cvc"
    },
    {
      "risk": "matched",
      "detail": "postcode",
      "type": "avs"
    },
    {
      "risk": "matched",
      "detail": "address",
      "type": "avs"
    }
  ],
  "paymentInstrument": {
    "type": "card/plain+masked",
    "cardBin": "444433",
    "lastFour": "1111",
    "countryCode": "GB",
    "expiryDate": {
      "month": 12,
      "year": 2029
    },
    "brand": "visa",
    "fundingType": "debit",
    "issuerName": "cardIssuer",
    "category": "consumer",
    "paymentAccountReference": "reference"
  },
  "_links": {
    "cardVerifications: verification": {
      "href": "https://try.access.worldpay.com/cardVerifications/{resource}"
    }
  }
}