FAQ

This section explains common issues you might encounter during integration.

Generic

What is OPC?

The Opaque Payment Card (OPC) is an encrypted object defined by the issuer. The OPC specification varies by payment network.

• Mastercard: Mastercard Issuer Tokenization Reference API.

• Visa: Visa In App Provisioning Reference API.

Card enrollment

Q: If a card is enrolled with 15 online merchants, do we receive information for all created tokens, or only for known merchants such as Netflix?

A: The D1 backend forwards the response from the payment network. It returns all known tokens, regardless of merchant or device.

See View: get token list.

Apple Pay tokens

Q: Do we receive Apple Pay token information and manage it from Android devices?

A: From the D1 backend perspective, getTokenList is device-independent. It returns all tokens, regardless of device.

The issuer application can filter tokens based on your use case.

Device type

Q: Are the device type and name only provided for device-based tokens?

A: Device ID, type, and name are only available for MDES tokens. They might not be provided, depending on the MDES response.

Android

How do I use the Push Provisioning SDK AAR in an Android library project?

If you are developing an Android library, you must merge the Push Provisioning SDK AAR. Merge it into your AAR file.

There are two ways to merge the AAR:

• If you use DexGuard, it can merge the AAR file. See the DexGuard documentation guide.

• Use a third-party framework such as fat-aar.

What is my customer application ID?

You receive the customer application ID when Google grants access to the Push Provisioning API. Access is only granted to participating financial institutions.

The issuer application must be allowlisted before it can call the API. This applies to Production apps and pre-release apps (for example, alpha or beta builds).

To request access to Google’s Push Provisioning API, follow the steps in Push Provisioning API Access. You can include multiple app packages in one request if they share the same SHA-256 fingerprint.

How do I enable a provisioned card on a Wear OS device?

The Push Provisioning API is not supported on Wear OS devices. The only supported option is manual provisioning via Google Pay.

See this documentation for steps to use Google Pay on Wear OS devices.

iOS

What is the PrimaryAccountIdentifier value?

This is a unique identifier for a card provisioned to the wallet application. You can use primaryAccountIdentifier to check the card status with the getCardDigitizationResult API.

See Primary Account Identifier in Apple’s documentation.

What is a nonce value?

This is a random value generated by the issuer application or the issuer backend.

Provide it to the Push Provisioning SDK as a condensed UUID v4. Condensed UUID v4 removes all dashes from the UUID.

For example, 123e4567-e89b-12d3-a456-426614174000 becomes 123e4567e89b12d3a456426614174000.