On-screen digital card display
Learn how to securely present the digital card form and details to users directly in your mobile or web applications. This section outlines the necessary APIs to safely retrieve and display sensitive information, such as the full card number and CVV, on-screen. By implementing this feature, you can offer a seamless digital payment experience while maintaining strict data security standards.
Audience: Partner product, design, and engineering teams building the card surface in a Partner application, and MatchMove teams reviewing that surface before launch.
Scope: Non-tokenized virtual card art and the live card data the Partner application presents against it. All virtual card art is horizontal.
Not in scope:
Tokenized card art. Images shown in a third-party wallet after provisioning through MDES — Google Pay, Apple Pay. Those are specified per wallet project and configured during wallet enablement rather than retrieved from the API. Do not design them against a general specification.
Artwork design and submission: Required and prohibited elements in the artwork itself, clear space, color, imagery, and file preparation are covered in Card Design Submission. All virtual card art requires Mastercard approval before use — it is not covered by the physical card design approval. This guide assumes the artwork is approved.
Interactive reference
The canvas below is an annotated card face as it would appear inside an application. The card is drawn at actual size — 85.6 × 53.98 mm, the ID-1 format defined by ISO/IEC 7810 — and sits inside a phone outline so the proportions read correctly against a real screen. It is landscape only, as every virtual card design must be.
Four numbered annotations on the left mark the live fields and the rule for each. Two panels on the right separate what arrives inside the approved image from what the application draws itself. Connector lines tie each annotation to the element it describes.
The card, the Partner Pay branding, and the values on the face are all sample data for illustration — not a real card and not a MatchMove design.
Select any field or its annotation to read the rule that governs it. Click the card away from a field to see what the artwork layer covers. The eye control on the card edge switches between masked and sensitive mode.
Cases the canvas does not cover
The canvas shows a card whose artwork carries credentials on its front. Two other cases apply.
Credentials are not on the front of the artwork. The cardholder name, PAN, expiry, and security code must then appear near the card art in the application rather than over it.
Numberless designs. The image omits or masks the PAN, expiry, and security code — either way, credentials are delivered and accessed in the app rather than read off the card face. A numberless design requires an approved DFCP (Digital First Card Program) before the card design can be submitted. The cardholder name may still appear.
References
- Card Design Submission — artwork requirements, clear space, color, file preparation, and the network approval path. Authoritative for card design; this guide defers to it.
- Mastercard Card Design Standards — authoritative for placement coordinates, minimum sizes, and exact measurements. Gated on Mastercard Connect; route questions through your MatchMove implementation contact.
- The Mastercard design template (.ai) — authoritative for placement where this guide and the template differ.
On this page
- On-screen digital card display