2. Onboarding

Provide onboarding data

Before you start integrating the NFC Wallet SDK, exchange a set of application identifiers, keys, and endpoints with the Thales delivery team.

Send required data to the Thales delivery team

Provide the following information for your digital wallet application.

Parameter	Format	Description
PreProd FCM service account	JSON file	Enables sending push notifications to your digital wallet application in the PreProd environment.
Production FCM service account	JSON file	Enables sending push notifications to your digital wallet application in the Production Environment.
Apple Team ID	Alphanumeric string	Your Apple Developer team identifier.
App ID	String	Your application identifier (for example, a bundle identifier).

Use Apple Team ID and App ID to derive the application binding key.

Thales uses this key to bind wallet enrollment requests to your digital wallet application.

Only registered digital wallet applications can enroll wallets. See Enroll wallet.

Get your application data

Get FCM service account

For details on FCM Service account, see the Firebase Console.

Then contact the Thales delivery team to complete the push notification setup.

FCM can deliver push notifications to the same digital wallet application from multiple senders.

Get Apple Team ID and App ID

Get your Apple Team ID and App ID from your Apple Developer account and/or Xcode project settings.

Receive this from the Thales delivery team

Configure the following values in your digital wallet application and, if applicable, your backend.

Parameter	Description	Format
PreProd source IP addresses	IP addresses to allowlist in FCM so the Thales backend can send push notifications to the PreProd environment.	Comma-separated list of IPv4 or IPv6 addresses
Production source IP addresses	IP addresses to allowlist in FCM so the Thales backend can send push notifications to the Production Environment.	Comma-separated list of IPv4 or IPv6 addresses
PreProd URLs	Endpoints to connect to the Thales backend in the PreProd environment.	String
Production URLs	Endpoints to connect to the Thales backend in the Production Environment.	String
PreProd card information encryption key	Key to secure transmission of card information (PAN, CSC, and expiration date) in the PreProd environment.	Hexadecimal string or PEM certificate
Production card information encryption key	Key to secure transmission of card information (PAN, CSC, and expiration date) in the Production Environment.	Hexadecimal string or PEM certificate