By using the Card API, we can quickly connect your customers to the Mastercard network.

Use the Cards APIs to perform the following:

• Managing cards by retrieving a list of card types
• Update the card to a new card profile
• Retrieve a cardholder’s cards
• Update the state of an individual card identified by card-id
• Retrieve a specific card
• Search for a card using CardType
• Retrieve any cards listed under a specified uid
• Manage authorizations and transactions.

Appendix

Card Type

Physical Card

Physical cards need to be mailed to the user. Once received, the user needs to call /v1/card/activate-card to activate it.

Virtual Card

Virtual cards are activated immediately upon issuance.

Card status

NEW - The card is newly initiated and awaiting processing.

CREATED - The card is registered in the system.

DISPATCHED - The physical card has been mailed to the customer.

INVALID - The card is marked invalid (e.g., due to data discrepancies).

ACTIVE - The card is activated and ready for use.

TEMP_BLOCKED - The card is temporarily disabled.

PERM_BLOCKED - The card is permanently disabled.

Card application status

UNDER_REVIEW - Application is pending and under review.

PROCESSED - Application has been processed.

REJECTED - Application is rejected.

APPROVED - Application is approved and card issuance is in progress.

Card authorization type

PURCHASE_AUTHORIZATION - Pertains to a purchase transaction.

REFUND_AUTHORIZATION - Relates to a refund transaction.

Card transaction types

REFUND

PURCHASE

Card transaction sources

POS_IN_WALLET - Transaction occurred at a Point Of Sale (POS) terminal, using a wallet-integrated card.

POS_OUT_OF_WALLET - Transaction at a POS terminal, with a card not integrated into a digital wallet.

ATM_IN_WALLET - ATM transaction using a card integrated into a digital wallet.

ATM_OUT_OF_WALLET - ATM transaction with a card not linked to a digital wallet.

E_COMMERCE - Online transaction for goods or services.

PARTNER_INITIATED - Transaction initiated by a partnered entity or service.

CUSTOMER_INITIATED - Transaction directly initiated by the customer.

INTERNAL_TRANSFER - Internal transaction, such as fund transfers within the same banking entity.

MOBILE_COMMERCE - Transaction conducted through a mobile commerce platform.

ON_US_TRANSACTION - Transaction processed within the same financial network or institution.

ONLINE_OUT_OF_WALLET - Online transaction with a card not stored in a digital wallet.

Card block reasons

REPORTED_LOST_OR_STOLEN - The card is reported as lost or stolen.

TEMPORARY_SUSPENSION - The card is temporarily suspended, perhaps for security checks or due to suspicious activities.

FRAUD_PREVENTION - The card is blocked as a preventative measure against suspected fraudulent activities.

SYSTEM_RELATED - The block is due to system-related issues, such as technical glitches or maintenance requirements.

ACTIVATION_RELATED - The block pertains to issues encountered during the card's activation process.

DEACTIVATION - The card is deactivated, rendering it inactive and unusable.