Skip to content
APIs/Card Verifications/Verifications

Verifications (4)

Determine the validity of your customer's card to maximize authorization rates.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Test (Try)
https://try.access.worldpay.com
Live
https://access.worldpay.com

Root

Verifications root resource, returns links to available Account Verifications actions.

Operations

Verifications

Verify tokens root resource, returns links to available verifiedTokens actions.

Operations

Verification resource retrieval

Request

Retrieval of a successful verification.

Security
BasicAuth
No request payload

Responses

Retrieval request successful

Bodyapplication/vnd.worldpay.verifications.accounts-v4.hal+json
outcomestringrequired
checkedAtstringrequired
riskFactorsArray of objects
riskstringrequired
detailstring
typestringrequired
paymentInstrumentobject
typestringrequired
cardobject
Response
application/vnd.worldpay.verifications.accounts-v4.hal+json
{
  "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",
    "card": {
      "number": {
        "bin": "444433",
        "last4Digits": "1111"
      },
      "countryCode": "GB",
      "expiryDate": {
        "month": 12,
        "year": 2029
      },
      "brand": "visa",
      "fundingType": "debit",
      "issuer": {
        "name": "cardIssuer"
      },
      "category": "consumer",
      "paymentAccountReference": "reference"
    }
  },
  "_links": {
    "verifications:verification": {
      "href": "https://try.access.worldpay.com/verifications/accounts/{resource}"
    },
    "curies": [
      {
        "name": "verifications",
        "href": "https://try.access.worldpay.com/rels/verifications/accounts/{rel}",
        "templated": true
      }
    ]
  }
}

Verification

Verify tokens root resource, returns links to available verifiedTokens actions.

Operations