Skip to content

Tap to Pay on iPhone SDK

A hand holds an iPhone showing a Tap to Pay on iPhone prompt to pay $17.25 while another hand taps a contactless card against the phone

Accept in-person contactless payments on iPhone with no extra hardware. The Finix Tap to Pay on iPhone SDK is built on Apple's Tap to Pay on iPhone technology and handles the full payment through Finix. Your app starts a transaction, the Buyer taps a card or digital wallet on the merchant's iPhone, and the SDK returns a completed Finix transaction.

Using the Finix Checkout app?

This section is for developers integrating the SDK into their own iOS app. To accept Tap to Pay on iPhone payments without writing code, see Accept Payments with Tap to Pay on iPhone in the Finix Checkout app.

How it works

  1. Your app starts a transaction with an amount and a transaction type.
  2. The SDK presents Apple's secure card-reading sheet and the buyer taps a card or device. The card read happens entirely inside Apple's Tap to Pay on iPhone technology, so your app and the SDK never see raw card data.
  3. The SDK submits the payment to Finix and waits for the outcome.
  4. The SDK returns the transaction result with the Finix transaction ID, its state, and masked card details.

Throughout the transaction, the SDK publishes progress events (card reading, processing, success or failure) that you can use to drive your UI.

What the SDK handles and what you build

The SDK handles:

  • Apple's Tap to Pay on iPhone session and card-reading UI.
  • Presenting Apple's Terms and Conditions when you link the merchant's Apple Account.
  • Authentication with Finix and secure token lifecycle. You never handle tokens.
  • Submitting the transaction to Finix and returning the outcome.
  • Progress events for your transaction UI.

Your app builds:

  • The checkout button and the outcome screens around a transaction.
  • Receipt UI. Optionally use the Finix Receipts API to send them.
  • Device provisioning against the Finix API, typically from your backend.

Next steps

Getting Started

Set up your Apple and Finix prerequisites before you build.

Demo App Walkthrough

Run the Finix reference app to see a working integration end to end.

Integration Guide

Add the SDK to your own iOS app, from install through first transaction.

SDK Reference

Field-level reference for the classes, methods, and events exposed by FinixTapToPaySDK.

Privacy & Data Collection

What the SDK collects, and how to opt out of crash reporting.

Testing Your Integration

Set up a Sandbox Apple Account, run the manual test checklist, and write unit tests.

Prepare for App Review

Apple's user-experience requirements for Tap to Pay on iPhone apps, mapped to your Finix integration.

Troubleshooting and Support

Symptom-driven fixes, Apple reader codes, and where to get help.