Card personalization and distribution
This section explains how cards move from your program configuration to your cardholders' hands — covering both virtual and physical cards, the distribution models available, and the integration touchpoints your platform needs to support along the way.
Overview
Card distribution is the end-to-end journey of a card from issuance request to an active, transaction-ready card. On the MatchMove Banking Operating System, this journey differs by card type:
- Virtual cards are issued and delivered instantly through the API. There is no physical card to prepare or deliver — the card is available to the cardholder the moment issuance succeeds.
- Physical cards must reach the cardholder before they can be used — whether personalized cards are delivered to them or distributed as non-personalized stock to the partner for the last mile delivery. These cards will remain inactive until the cardholder activates them.
Understanding which model your program uses determines which parts of this guide apply to your integration.
Scope
This document covers the distribution journey: from the point a card is issued under your program through delivery or hand-over to linking and activation. It applies to both virtual and physical cards across all distribution models.
The following assumptions apply throughout:
- Card design has been approved. Once the network approves your card artwork against their branding guidelines
- Virtual card designs can be displayed digitally within the partner’s app or website
- For physical cards, this approval clears the design for mass production
- Cards are already manufactured (blank card). Card manufacturing, data preparation and file transmission, data injection (required for the personalization process), surface printing, and packaging occur separately during the card kitting and fulfillment phase and fall outside the scope of this document.
Before You Issue A Card: Program Prerequisites
Launching a card program involves several critical milestones that must be reached before your platform can execute its first issuance API request. During this onboarding phase, you will collaborate with your MatchMove account team to finalize the following configurations:
- BIN and card design approval — physical and virtual card artwork must be approved against network branding requirements before cards can be produced.
- Program configuration — a specific
card_typeis assigned to each unique card product, defined by its form and design. Each combination is its own card product with its owncard_type— even two personalized physical cards that differ only in color, say a blue edition and a red edition, are two distinct card products. These must be added to the system under your program before they can be issued. This is configured by your MatchMove account team once the card design is approved. - Card stock (physical programs, production only) — for physical card issuance, manufactured card stock must be available first (for both personalized and non-personalized card models). Lead times apply to initial stock and replenishment. This prerequisite applies only to the production environment — there is no physical card production in staging, so integration and UAT can proceed without stock in place.
Once these are in place, your platform can begin issuing cards programmatically.
Virtual Card Issuance
Virtual cards follow the simplest issuance path because no delivery of the card is needed.
When your platform calls the card issuance endpoint for a verified customer, the platform generates the card, links it to the customer's wallet, and returns a card reference. From that point the card is live. Your application then surfaces the card details to the cardholder through the secure card display mechanism — full PAN, expiry, and CVV are never returned in plain API responses and must be rendered through the secure retrieval flow.
Because there is no physical journey, the operational focus for virtual programs is on the moments around issuance: ensuring the customer has completed KYC before the issuance call and handling issuance failures gracefully.
Physical Card Issuance and Distribution
Physical cards introduce a journey between issuance and use. How the journey works depends first on the card class your program uses:
Personalised Cards
(Model 1)
These cards are produced for a specific customer and carry their personal identity.
Card Features
- The cardholder's name is embossed or printed on the card, and the expiry date matches the date it was ordered on the platform.
Production Process
- Blank cards are kept in inventory. Personalization (embossing names and encoding credentials) occurs in batches as issuance requests are received.
Distribution & Last Mile Delivery
- Because the customer is known, these follow direct-to-cardholder distribution. The last-mile delivery leg is usually handled by an appointed courier connected to the MatchMove platform.
Non-Personalised Cards
(Model 2)
These cards are produced as generic stock with no cardholder identity and a generic expiry date.
Assigned After Last Mile Delivery
- The card is sent to the user without any assignment happening before last-milemile delivery request is raised.
- The user can activate any generic card they receive.
- To activate, the user must provide card details that match the bulk card records maintained in the partner's database.
Non-Personalised Cards
(Model 3)
These cards are produced as generic stock with no cardholder identity and a generic expiry date.
Assigned Before Last Mile Delivery
- The card is bound/assigned to a specific user before the last-mile delivery A request is raised.
- Only the specific user can activate the assigned card.
- If an unassigned user attempts activation or the card received is incorrect, the partner's database will reject the request.
1 — Direct to cardholder | Personalized | At issuance | Activation |
2 — Assigned After Last Mile Delivery | Non-personalized | After last-mile delivery | Linking, then activation |
3 — Assigned Before Last Mile Delivery | Non-personalized | Before last-mile delivery | Activation |
Model 1 — Direct-to-Cardholder Distribution (Personalised)
Each card is personalized for a specific customer and shipped directly to them.
- Issuance request. Your platform calls the issuance endpoint with the cardholder's details, including the delivery address.
- Personalization. Issuance requests are processed in batches: a pre-manufactured blank card is embossed or printed with the cardholder's name and encoded with the card credentials.
- Delivery. The personalized card is packaged with its carrier and delivered through a MatchMove platform-chosen arrangement: dispatched directly to the cardholder's address via platform-enabled couriers. Specific delivery methods and timelines vary by market and arrangement.
- Delivery and activation. The card arrives inactive. The cardholder activates it through your application, which calls the card activation endpoint. Until activated, the card cannot transact.
This model suits programs where cardholders sign up remotely — the trade-off is delivery lead time between issuance and first use. Many programs pair a physical card with an instantly issued virtual card so the cardholder can transact immediately while the physical card is in transit.
To learn more about how you can issue a personalized physical card, you may go to the Request for a personalized physical card section.
Model 2 — Assigned After Last Mile Delivery (Non-Personalised)
Non-personalized card stock is distributed to your customers directly — handed over in person at retail locations, branch offices, or event sites, or delivered without prior assignment. The card reaches the customer before it is tied to any account, so the customer completes the linking themselves.
- Stock distribution. Unassigned cards are produced in one go and delivered to your one centralized appointed distribution point. The Partner will then arrange for its own next distribution services to their retail partners or ship onward directly to customers. Each card carries a unique reference but no cardholder identity.
- Handover and Last Mile Delivery. After undergoing the personalization process, the printed bulk of personalized cards will be handed over from MachMove and then handed over to the Partner at the bureau center. After that, the partner will handle the last-mile delivery to the cardholder either via its own arrangement or by connecting to a MatchMove-appointed courier company. The card is given to a customer — either an existing user of your program or a brand-new one. New customers must complete registration and KYC before the card can be linked.
- Card linking / assignment. The customer goes through the card linking process, which links that specific card to their verified account.
- Card activation. Once linked, the customer completes activation. Only after both steps is the card ready to transact.
This model eliminates shipping waits for in-person distribution and is the only model that supports acquiring brand-new customers at the point of hand-over. The operational responsibility shifts to your side: physical stock custody, inventory reconciliation, and secure handling of unassigned cards at each location.
To learn more about how you can link an existing user to a non-personalized card, you may go to Link & activate a non-personalised physical card (Non-personalized) section.
Model 3 — Assigned Before Last Mile Delivery (Non-Personalised)
Non-personalized stock is linked to a customer before it leaves your custody. Each card is assigned to an existing, verified user in the system and only then dispatched to them.
- Card linking / assignment. Your platform assigns a specific card from stock to an existing user's account. The link is established system-side — the customer takes no action at this stage.
- Handover and Last-Mile Delivery. Similar to Model 2, there will be a handover of the bulk personalized printed cards from the personalization bureau to the Partner.
Then the Partner will be responsible for managing the last-mile delivery to the cardholder either via its own logistics/courier company or through MatchMove-appointed courier partner - Card activation. On receipt, the customer completes activation only — no linking step is needed, because the card is already linked to their account.
This model combines the production economics of non-personalized stock with the simpler cardholder experience of Model 1: the customer receives a card that is already theirs and has just one step between receipt and first use. It requires that the customer already exist in the system, so it suits programs distributing to an established user base rather than acquiring new customers at handover.
Card Order and Delivery Service
For card programs that require last-mile delivery or courier assistance, MatchMove offers the Card Order and Delivery Service — an added, subscription-based service that takes over the delivery leg of the distribution journey. When enabled, the cards are dispatched to your cardholders through the platform's integrated courier network (see Card Delivery Options), supported by two capabilities that make deliveries reliable and visible. The service is activated per program and currently available in select regions; check with your MatchMove account team whether it can be enabled for your market.
The two supporting capabilities address the questions every delivery-based program eventually faces: can we actually deliver to this address? And where is the card right now?
Address serviceability checks validate a cardholder's delivery address before a card order is placed. Confirming up front that an address can be delivered to prevent delivery failures before production even begins — catching the problem at order time, when it costs a correction, rather than at delivery time, when it costs a returned card, a reissue, and a frustrated cardholder.
Card order tracking provides end-to-end visibility of each order across the full journey — from initial order and personalization through to final delivery at the cardholder's doorstep. Your teams can retrieve the current status of any card order, and you can surface that same visibility to cardholders in your own application.
Together, these capabilities reduce failed deliveries, cut reissue costs, and lower support volume during the delivery window — the period when cardholders are most likely to reach out asking where their card is.
Card Linking / Assignment
Card linking applies to non-personalized cards distributed under Model 2. It is the step that turns a generic card into the customer's card: the physical card they are holding is bound to their verified account in the system, and from that point the card belongs to them alone.
Linking is necessary in Model 2 because of when the card changes hands. The customer receives the card before any relationship between card and account exists — unlike Model 1, where the card is produced for a known customer, or Model 3, where your platform assigns the card before dispatch. Until linking happens, the card in the customer's hands is inert plastic: it carries a unique reference, but it is connected to no account, holds no funds, and cannot transact. This is also what makes non-personalized distribution safe to operate at scale — a card lost or stolen before linking cannot be used by anyone.
The linking journey looks like this from the customer's perspective:
- Be a verified customer. Linking requires a registered, KYC-verified account. Existing customers already meet this; new customers who received a card at hand-over complete registration and verification first.
- Identify the card. Two numbers on the card are needed to link it: the card proxy number (a non-sensitive reference that identifies the physical card) and the PAN (only the last 4-digit card number is needed for verification). How the customer captures these depends on the card design. On standard designs, the numbers are printed on the card and can be entered directly. Any design can also carry a QR code that the customer scans to be taken into the linking journey with the card already identified — and on numberless designs, where the numbers are hidden from the card face, the QR code is usually the primary way in. The customer provides these details through your application, telling the system exactly which physical card they hold.
- Link confirmed. The system binds that specific card to the customer's account. The card now appears under their profile, and the customer proceeds to activation.
Linking is a one-time, permanent association — once a card is linked to an account, it cannot be re-linked to a different customer.
To learn more about card linking or assignment, you may go to Link & activate a non-personalised physical card (Non-personalized) section.
The QR Code on the Card
For card designs that carry a QR code (usually printed on the back of the card), the code encodes a URL that takes the customer straight into the card journey — scanning it identifies the card without the customer typing anything.
Sample QR URL format
<Partner static URL> + / + <8-digit Card Proxy number> + <4-digit PAN number>
e.g. https://<matchmove-partner>.com/123456789999

The URL is composed of:
- Partner static URL — your fixed base address. This can be a universal link, so a scan can land the customer on your app landing page or directly invoke your mobile app itself, dropping them straight into the card linking experience.
- Card proxy number — the 8-digit non-sensitive reference that identifies the specific physical card.
- Last 4 digits of the PAN — can be used as a partial confirmation of the card number.
For security purposes, only the last 4 digits of the PAN are loaded into the URL — never the full card number. URLs are inherently exposable: they can appear in browser histories, server logs, and shared links, so the full PAN is deliberately kept out of the QR code to ensure the card number is never exposed digitally.
Activation and First Use
Regardless of distribution model, a physical card's lifecycle gate is activation. Activation can only begin once the card is linked to the customer — whichever model established that link: at issuance for personalized cards (Model 1), through the customer's card-linking process (Model 2), or through system-side assignment (Model 3). Only then can card activation be started. Your integration should treat activation as a deliberate cardholder action — typically triggered from your app after the cardholder confirms receipt — rather than an automatic step.
For programs on mJIT funding, remember that activation makes the card usable, but every transaction is still authorized in real time against your funding decision. For standard funding programs, ensure the associated wallet is funded before the cardholder's first transaction attempt.
To learn more about the card activation process, you may go to the Link & activate a non-personalised physical card, and Activate a personalised physical card sections.
On this page
- Card personalization and distribution