LogoLogo
StatusChangelogDashboardCreate a Ticket
  • Getting Started
  • Intro to APIs
  • How to Contact us
  • How to Go-Live
  • Intro to Risk
  • Intro to Spec Sheets
  • Product Guides
    • Deposit Hub
      • 🌎Global Cash
    • Credit Hub
    • Payment Accounts
    • ID Score
  • API References
    • OAuth
      • OAuth Object Details
      • Create OAuth Key
      • Generate Refresh Token
    • Users
      • User Object Details
      • Testing on UAT
      • View All Users
      • View User
      • Create User
      • Update User
      • Generate UBO Doc
      • Manage Duplicates
      • Allowed Document Types
      • Allowed Entity Scopes
      • Allowed Entity Types
    • Nodes
      • Node Object Details
      • Testing on UAT
      • View all User Nodes
      • View Node
      • Create Node
      • Update Node
      • Generate eCash Barcode
      • Allowed Node Types
      • View ATMs
    • Subnets
      • Subnet Object Details
      • Testing on UAT
      • View all Node Subnets
      • View Subnet
      • Create Subnet
      • Update Subnet
      • Push to Wallet
    • Shipments
      • Shipment Object Details
      • View all Subnet Shipments
      • View Shipment
      • Create Shipment
      • Cancel Shipment
    • Statements
      • Statement Object Details
      • View all User Statements
      • View all Node Statements
    • Transactions
      • Transaction Object Details
      • Testing on UAT
      • View all User Transactions
      • View all Node Transactions
      • View Transaction
      • Create Transaction
      • Create Batch Transactions
      • Cancel Transaction
      • Retry ACH Transaction
      • Dispute Chargebacks
      • Dispute Transaction
    • Subscriptions
      • Subscription Object Details
      • Webhook Object Details
      • Testing on UAT
      • View all Subscriptions
      • View Subscription
      • Create Subscription
      • Update Subscription
      • View Webhook Logs
    • Miscellaneous
      • Dummy Transactions
      • Verify Address
      • Verify Routing Number
      • International WIRE-INT Required Data by Country
      • View Billers
      • View Enriched Data
      • Loan Limits
      • Transaction Decisioning
      • 3D Secure
      • Virtual Terminal
      • Pre-Authorization
      • Card Disputes Guide
      • Mobile Wallets
      • Interchange Revenue
      • Enrichment Guide
  • Developer Guides
    • User Onboarding
      • Create User Flow
      • Authenticate as the User
      • Create Node Flow
        • Cash Advance
        • Credit Builder Loan
        • One Time Loans
        • Secured Open Loans
        • Secured Revolving Loans
        • Unsecured Revolving Loans
      • Create Subnets Flow
        • Creating Cards
        • Creating AC/RT
      • Linking External Accounts
        • Linking Cards
        • Linking External Bank Account
      • Add Additional Documents
    • Account Details
      • Displaying Balances
      • Transaction History
      • Transaction Details
      • Account Agreements
      • Node Statements
      • Card Details
    • Managing Cards
      • Card Preferences
      • Setting PIN
      • Mobile Wallet Flow
        • Integrate with Apple Pay
        • Integrate with Google Pay
        • Integrate with Samsung Pay
      • Shipping Cards
    • Originating Transactions
      • Sending Fed Wires
      • Sending ACH Transfers
      • Sending International Wires
      • Deposit a Check
      • Issuing Checks
      • Recurring Transactions
      • 3rd Party Payment Accounts
      • Cancelling Transactions
      • Exceeding Origination Limits
    • Receiving Transactions
      • Transaction Decisioning
      • Receiving ACH / Wires
      • Card Transactions
      • Exceeding Inbound Limits
    • Managing Disputes
      • ACH Disputes
      • Card Disputes
    • 3rd Party Integrations
      • Payment Integrations
      • Account Aggregators
      • 3rd Parties & Compliance
  • Recipes
    • Overdraft Protection
    • Social Banking
    • Monetizing Transactions
Powered by GitBook
On this page
  • Intro
  • Manually Provisioning a Card to a Mobile Wallet
  • Instant Provisioning to Mobile Wallet
  • Mobile Wallet Fraud Protection
  • Card Art Specs
  • Short Description
  • Card Artwork
  • Card Art Colors
  • Updating Card Art

Was this helpful?

Export as PDF
  1. API References
  2. Miscellaneous

Mobile Wallets

PreviousCard Disputes GuideNextInterchange Revenue

Last updated 2 years ago

Was this helpful?

Intro

Mobile Wallets are digital wallets held on mobile devices that transact with merchants by turning Native Card Primary Account Numbers (PANs) into digital tokens (e.g. for use with Apple Pay, Google Pay, Samsung Pay, Fitbit Pay, etc.). Further, you can customize how the will be digitally represented on a mobile device.

There are two ways to connect a card subnet with a mobile wallet of choice:

Manually Provisioning a Card to a Mobile Wallet

As with most cards, end users can add cards to their preferred mobile wallet (e.g. directly from Apple Pay, Google Pay, or Samsung Pay) by providing their card details (e.g. PAN, expiration date, CVV, billing address, etc.) to the mobile wallet provider. However this process either requires end users to digitally scan their cards using OCR (Optical Character Recognition) or provide their card details via manual text input.

Instant Provisioning to Mobile Wallet

can now also be added directly from your app to a user's mobile wallet with the click of a button through a process called "Instant Provisioning" (see ). This new feature allows users to quickly and efficiently integrate their cards with their Apple, Google, and/or Samsung digital wallets, with the added benefit of reducing both failed OCR error and manual text entry errors associated with standard manual card provisioning.

Mobile Wallet Fraud Protection

While protecting payment transactions in flight is a critical part of reducing card-related fraud, with mobile wallets, there is the ability to reduce fraud at the time of provisioning cards into mobile wallets like Apple Pay and Google Pay. To help Platforms reduce fraud during card provisioning with these services, we have extended the data fields that we are consuming during provisioning to trigger additional fraud checks at the time of provisioning.

Multi-Factor Authentication Support

Through the enablement of multi-factor authentication, Platforms can leverage a verified phone number/email.

CVV2 Throttling

In order to assist in the prevention of fraud from suspicious activity, cards will now be locked out of mobile wallet provisioning for 24 hours in certain cases in which the system flags an increased risk of fraud, including a certain level of bad CVV2 attempts in a period of time.

Card Art Specs

Mobile Wallet Art will be associated with virtual card profiles. Each profile will map to all of the tokens that use its card art. Therefore, to update the card art for multiple tokens that share a particular card profile, you simply need to update the card profile with new art. Conversely, to only update the card art for a single token, you would re-assign that token to a different card profile (i.e. either to another existing card profile or to a new one). When submitting a card art, please provide the following:

Short Description

A short description of the card (e.g. for lock screen notifications). This short description should include the word "Mastercard" and can be a maximum of 32 characters in length.

Card Artwork

Brand Mark Image

Platform Logo Image

SVG (recommended) or PNG image in RGB color format. The image dimensions can be up to 1372 x 283 pixels.

Card Background Image

SVG (recommended) or PNG image in RGB color format. The image dimensions must be 1536 x 969 pixels and have square corners.

Combined Art Work

Card background + platform logo + brand mark (Mastercard).

If Debit, cards must include the "debit" identifier. SVG (recommended) or PNG image in RGB color format. The image must be 1536 x 969 pixels and have square corners. Example: Synapse's combined card art (below).

App Icon

For push notifications related to the card. PNG or SVG image in RGB color format The image must be exactly 100 x 100 pixels. Example: Synapse's approved app icon (below).

Card Art Colors

Background Color (Hex)

This is used to overlay the background of the card art.

Foreground Color (Hex)

This is used for the masked card PAN digits that are overlaid on the bottom left of the card image.

Label Color (Hex)

This is used for the short description text rendered on the card image if the card image (Card Background Combined or Card Background) is not available for some unexpected reason.

Updating Card Art

Please allot up to 10 business days after the card art has been accepted by us for the new card profile to take effect.

When card art is updated, all the tokens associated with the profile are automatically liked to the new card art.

If you wish not to do that, please request a new profile with new art to avoid changing all tokens.

The SVG for the brand mark used on the card image. See for available brand marks. It is recommended to use the Mastercard Symbol.

You can currently submit your card information and mobile wallet assets during implementation to your Implementation Manager or later by .

here
Push to Wallet
card subnet
Subnet Cards
creating a ticket