Choose an Add Method

This chapter covers user-initiated card addition. Select one link method, generate the link on a trusted system, and expose it through an approved Add to Samsung Wallet entry point.

For callbacks, updates and cancellations after a card is added, continue to Manage Card Lifecycle. For partner-initiated provisioning without a contemporaneous user click, see Server-Initiated Card Provisioning.

Choose the method before implementing the entry point. The method determines what the link contains and which partner endpoints are required.

Method

 Choose it when

 Link carries

 Partner API required at add time
Data Transmit Link

 The partner can generate the complete card payload when the user requests the card. This is the standard starting point for most integrations.

 Encrypted and signed card data in cdata.

 No card-data retrieval endpoint.
Data Fetch Link

 The card data is sensitive, changes immediately before issuance, or the same static entry point must resolve different card instances.

 An opaque partner reference in pdata.

 Get Card Data.
Data Action Link

 The approved flow must collect or authenticate user input before resolving the card.

 A predefined action in adata.

 Request Action and an onboarding-approved Action Data configuration.

Do not select a method solely to shorten the URL. Consider where card data is created, whether a link may be forwarded, how the user is resolved and which inbound APIs the partner can operate securely.

Decision sequence

  1. Start with Data Transmit Link if the complete card instance can be generated for the current user and placed in a short-lived cdata token.
  2. Use Data Fetch Link if Samsung Wallet must resolve an opaque refId against the partner server.
  3. Use Data Action Link only when the use case and action are agreed during onboarding.
  4. Use Server-Initiated Card Provisioning only when the card must be initiated by the partner rather than by a user selecting an ATW entry point.

After choosing, implement the exact URL contract in Add Card Links and the channel-specific presentation in Implement the Add to Samsung Wallet Entry Point.