Set up the Stax iOS SDK and required Apple configuration to accept contactless in-person payments with Tap to Pay on iPhone in your app.

Tap to Pay on iPhone lets your merchants accept EMV cards, Apple Pay, and other digital wallets without extra hardware, readers, or terminals. This page shows the SDK, entitlements, and Xcode settings you need to prepare your app for that flow.

Install the SDK

Use the Stax iOS SDK 2.5.X+ README for the latest installation details: here.

1. Download the Stax iOS SDK.
   1. The iOS bundle includes ChipDnaMobileObjectiveCDemo, ChipDnaMobileSwiftDemo, docs, and binaries.
2. Review the README installation steps so you can choose the package contents that match your app.
3. Add the SDK to your Xcode project.

Meet iOS Prerequisites

Complete these Apple requirements before you configure your project:

1. Run your app on iOS 17.4 or later.
2. Use Xcode 16.x or later.
3. Create an Apple Sandbox account in App Store Connect under Users & Access > Sandbox. Use this account for Tap to Pay testing.
4. Request Tap to Pay entitlements if you are the Apple Developer Account Holder.
   1. Request Development Entitlements for local builds.
   2. Request Publishing Entitlements before App Store release.
   3. List NMI as the PSP and include your deployment regions in the request.

Configure Project

After Apple approves your entitlements, update your Xcode project so the SDK can access Tap to Pay on iPhone features.

1. Add these capabilities in Xcode: App Attest, NFC Tag Reading, and Tap to Pay on iPhone.
   1. These capabilities enable the app attestation and NFC access required for Tap to Pay on iPhone.
2. Create a new provisioning profile and link it in Xcode.
   1. This ensures your build includes the approved Tap to Pay capabilities.
3. Add the required keys to your entitlements file.
   1. The example below uses the development App Attest environment for local builds.

<key>App Attest Environment</key><string>development</string>
<key>com.apple.developer.proximity-reader.payment.acceptance</key><true />
<key>Near Field Communication Tag Reader Session Formats</key>
<array><string>Tag-Specific Data Protocol (TAG)</string></array>

✅ You’re now ready to integrate the Stax iOS SDK into your app.

Optional: Review additional resources

Navigate the developer portal pages for more details, including visual aids, flow diagrams, and code samples.