Getting the card data

Flow showing how to get card and personal data

Get card details from user

The Primary Account Number and the Expiry Date are required for all card types. You can also supply the CVV.

The other details you must get are determined by the type of card or scheme; for example, the Issue Number is needed for Switch cards but not for credit cards. You should supply all dates as month (##) and year (####).

Get personal and address details

If you want to match a card and card holder, as well as the basic card details, you must get:

customer's first name and surname
card holder's address - you need the street, post code and one of:

house number
house name
flat number plus either house name or house number.

Perform card holder matching

To match the card and the card holder, call MatchCardHolder, supplying the standard card details with the name and address of the card holder.

This also validates the card details.

Get personal and extra card details

If you are verifying the card and personal details, as well as the basic card details, you must get:

name on the card
card holder's address - you need the post code plus the house number and flat number (where relevant) to perform an AVS check.

Perform verification

To verify the card and perform AVS and CVV checks, call VerifyAvsCvv, supplying the standard card details, name on the card and the address.

This also validates the card details.

Get sort code

You can only match debit cards to sort codes.

To match a debit card with an account, you must get the sort code as well as the standard card details. The sort code must be 6 numeric characters. The service removes all separators.

The Card Validation service does not validate the sort code. To validate the sort code, call the standard Bank Wizard Validate service.

Perform debit card matching

To match the debit card with the supplied sort code, call MatchDebitCardDetails supplying the card details and the sort code.

Perform validation

To only validate the card details, call ValidateCardDetails, supplying the standard card details.

The card details are automatically validated as part of verification, card holder matching and debit card matching. Therefore you do not need to perform this check if you are performing any of the other checks.