Credit & Debit Cards

This section provides on overview on Credit and Debit cards as Payment Profiles.

Credit and Debit cards are bank cards, and represent types of Payment Profiles associated with customers. You can retrieve a bank card information, create a bank card, update a bank card, and delete a card. Credit cards can also be validated via attributes and verified by address.

Due to PCI DSS compliance requirements, creating a credit or debit card outside of the Secure Payments UI requires the use of our card creation iframe. See our Create bank card guide for more information.

The card entity in Secure Payments holds a variety of information, or attributes, about the card.

Make sure to enable Advanced Card Attribute Lookup in Secure Payments before retrieving, validating, or verifying bank card information.

Updating or deleting a bank card requires the use of your OBO token in replace of the Secure Payments header.

You will find the key-value pairs for the card below.

Key-value pairs

Value:Definition:
cardholder_nameThe cardholder's name.
card_numberThe card's 16 digit number.
expiration_dateThe card's expiration date in MM-DD format.
addressThe cardholder's street address.
cityThe cardholder's city.
stateThe cardholder's state.
countryThe cardholder's country.
zipcodeThe cardholder's zip code.

For more information and to see how cards work in the UI, see our Payment Profiles article.