Introduction to Cards

Cards

GPS provides APIs to create cards, which can be either physical cards or virtual cards.
Physical cards are printed and sent to the cardholder. Virtual cards are not printed, but can be linked to a card image which is displayed to the cardholder when they log into their account.

Types of cards

GPS supports the creation and usage of cards for different purposes:

  • Prepaid cards and gift cards - the card is loaded with a prepaid amount that is available for the cardholder to spend. The card is not allowed to go into negative balance and you can provide a facility to enable your cardholders to load additional funds to the card if required.

  • Debit and Credit cards - on the GPS system there is no distinction between a debit card and a credit card. If you offer your cardholders a credit facility, you will need to have a separate arrangement with them relating to overdraft charges and loading the card with an available funds limit in accordance with their allowed overdraft facility. The GPS card must always hold a sufficient balance to enable a card payment.

Card manufacturers

You can submit a request to create a physical card which GPS will send to your card manufacturer. Note that you will need to sign a separate agreement with the card manufacturer. For a list of card manufacturers supported by GPS, contact your Implementation Manager.

Key Attributes of a card

Below is a list of some of the most important attributes that are linked to a card

Card Attribute

Description

PAN

16-digit Permanent Account Number (PAN) that is typically embossed on a physical card.

publicToken

Unique GPS token that is generated when a card is created and is always linked to the card. You can use the public token to query and update your cards.

expiryDate

The card's expiry date. This date determines when you will need to renew or replace the card.

status

The current status of the card. All cards are issued in an inactive state. Cards must first be activated before they can be used.

Cardholder Name

The cardholder's name, as printed on the card.

address

The address that is linked to the card. Note that this address may be used for sending replacement cards, and for payment authorisations that use the Address Verification Service (AVS).

mobile

The telephone number linked to the card.

CVV

The Card Verification Value (CVV / CVC2) on a credit card or debit card is a 3 digit number on VISA, MasterCard and Discover branded credit and debit cards. Cardholder's are typically required to enter the CVV during any online or cardholder not present transactions.

DPAN

A digital PAN (digital token), provided by Visa or Mastercard, that can be used instead of the PAN in card transactions.

availableBalance

The available balance on the card. This balance is adjusted after any transaction on the card that affects the available balance, such as a payment authorisation.

PIN

The Personal Identification Number (PIN) associated with the card. The cardholder enters their PIN when using the card at an ATM or Point of Sale (POS) terminal.


Did this page help you?