Web Push Provisioning for Apple Wallet
Before you start, make sure tokenization is live on your Bank Identification Number (BIN) and you've confirmed a build path with your Customer Success Manager.
Part 1: Requirements
Share Your Web Origins
Send your Customer Success Manager each web origin, the website address where the Add to Apple Wallet button will appear (for example, www.banking.com). There's no other Apple setup on your end.
Requirements Complete
Once you've shared your web origins, Unit configures them with Visa. Your Customer Success Manager will let you know when your configuration is complete and your developers can start the integration.
Part 2: Integration
Your developers start once Unit confirms that your configuration is complete. Add one of Unit's components to your website. Each one needs the card ID and a customer token for the end customer. Either one covers both Apple Wallet and Google Wallet, so if you've already added a component for one wallet, it covers the other as well.
- Card component: The full card interface, with Add to Wallet built in. Follow the web steps in the Card component guide.
- Add to Wallet component: Only the Add to Wallet buttons, for your own card interface. Follow the Add to Wallet component guide.
You can build the Add to Wallet button and flow from scratch instead of using a Unit component. Expect significantly more engineering time and more extensive approvals. Talk to your Customer Success Manager before you start.
Part 3: Test and Launch
Step 1: Test Your Integration
Contact your Customer Success Manager for guidance on testing. To run the Add to Apple Wallet flow end to end, you need:
- Apple Account: To sign in and start the flow from your website.
- iPhone with the Apple Wallet app: The flow starts in a browser, but the card is added to Apple Wallet on the device, so you need one to confirm the card arrives.
The iPhone must be signed in to the same Apple Account you use to start the flow. If it isn't, the card won't appear on the device, even though the web flow completes successfully.
Step 2: Send Your Field Testing Results
Add a card to Apple Wallet from your website, make a purchase with that card in Apple Wallet, and then send your Customer Success Manager:
- Provisioning recording: A full recording of the web provisioning flow, ending with confirmation that the card was successfully added to Apple Wallet.
- Receipt: A picture or screenshot of the receipt for the purchase.
- Transactions screenshot: A screenshot of the card's transactions list in Apple Wallet, showing the purchase.
Send the recording as an .mp4 file, and the receipt and transactions screenshot as .png files.
Apple's Launch Approval
Unit coordinates your approval with Visa and Apple on your behalf, using the field testing results you sent.
Unit's Launch Approval
Once Apple approves, Unit enables web push provisioning for your program in production, and the Add to Apple Wallet button goes live for your end customers on your website.