Skip to main content

Audience:

DevelopersOperators

Digital cards

A virtual or physical card added to Apple Pay or Google Pay for contactless payments, kept up to date automatically by Swan.

Digital format of a virtual or physical card. Swan cards can be digitized and added to Apple Wallet and Google Wallet for Near-Field Communication (NFC) payments. Other digital wallets aren't supported.

Swan cards are compatible with Apple Pay and Google Pay.

If you choose to allow digital cards, your cardholders can add their cards to their preferred digital wallet. Swan recommends only digitizing virtual cards for a safer experience.

A list of digital cards is available in the cards query.

Adding cards to digital wallets

Subject to approval

You need Swan's approval to add Apple Pay or Google Pay to your product. To request it, contact your Strategic Account Manager (SAM).

Only enabled virtual cards and activated physical cards can be digitized. Virtual cards are enabled almost immediately, but make sure your cardholders activate their physical cards before trying to digitize them.

Add to Apple Wallet and Add to Google Wallet badges

There are multiple ways to add cards to a digital wallet:

  1. Your cardholders can do it themselves by entering their virtual or physical card number into the digital wallet.
  2. Your cardholders can use the Swan App and follow the in-app provisioning process.
  3. You can initiate the in-app provisioning process through the addDigitalCard mutation, or the addDigitalCards mutation for several cards at once.
  4. If cardholders start manual provisioning but don't complete it, you can help them transition to in-app provisioning using the activateDigitalCard mutation (requires Apple Pay or Google Pay certification).

Renewing digital cards

Swan takes care of updating digital cards with Apple Pay and Google Pay. This requires no action from you or your cardholders.

The digital card lifecycle is described in digital card statuses.

Certifying your digital card integration

You need to certify your digital card integration before your cardholders can use Apple Pay and Google Pay.

Use the Partner Support Request form on your Dashboard, specifying that you'd like to activate in-app provisioning for digital payments. The team will help you get started.

Provisioning guide

A complete provisioning guide can't be published on this site due to privacy policies from Google and Apple. Swan will provide one after you've certified your digital card integration.