Mastercard · Schema
Mastercard Card
A Mastercard payment card representing a physical or virtual card instrument issued to a cardholder. Covers prepaid, debit, credit, and commercial card products across Card Issuance, BIN Lookup, Benefit Eligibility, and tokenization services.
Credit CardsDigital IdentityFinancial ServicesFraud DetectionOpen BankingPayments
Properties
| Name | Type | Description |
|---|---|---|
| cardNumber | string | Primary Account Number (PAN) for the card. Must pass Luhn algorithm validation. |
| cardId | string | Unique system-generated identifier for the card within the Mastercard issuing platform. |
| cardPackId | string | Identifier for the card pack, used in card issuance and fulfillment. |
| cardType | string | Classification of the card product. |
| cardProductCode | string | Three-character code identifying the specific card product (e.g., MSI for Mastercard Standard, MWE for World Elite, MWO for World). |
| planCode | string | Card plan code defining the card product configuration and features. |
| programCode | string | Program code for the card product within the issuing institution. |
| brand | string | Card brand within the Mastercard network. |
| tier | string | Card tier or level indicating the product benefits tier. |
| status | string | Current lifecycle status of the card. |
| issuedDate | string | Date the card was issued, in ISO 8601 date format. |
| expirationDate | string | Card expiration date in MMYY format. |
| embossedName | string | Name embossed or printed on the physical card. |
| numberless | boolean | Indicates whether the card number is printed on the physical card. True means the number is not printed. |
| instant | boolean | Indicates whether the card was issued as an instant card (immediately generated). |
| virtual | boolean | Indicates whether this is a virtual card with no physical plastic. |
| contactless | boolean | Indicates whether the card supports contactless (NFC/PayPass) transactions. |
| photoIndicator | string | Indicates whether a photo is required on the card. |
| deliveryMode | string | Mode of card delivery to the cardholder. |
| deliveryDate | string | Date the card was delivered or handed over to the client, in ISO 8601 format. |
| tokenNumber | string | MDES (Mastercard Digital Enablement Service) token representing this card for digital transactions. |
| binNumber | string | Bank Identification Number (BIN), the first 6-8 digits of the card number identifying the issuing institution. |
| issuerId | string | ICA (Interbank Card Association) number of the issuing institution. |
| issuerName | string | Name of the financial institution that issued the card. |
| issuerCountryCode | string | ISO 3166-1 alpha-3 country code of the issuing institution. |
| cardholder | object | |
| limits | object | |
| applicationType | string | Type of card issuance application. |
| corporateCode | string | Unique code of the corporate entity for commercial/corporate cards. |