Test your Tap to Pay on iPhone implementation in test mode, request publishing entitlements, and prepare for Apple app review before distribution.

Test your application

When your implementation is code complete, test it with a test merchant before you prepare for release. Contact your Account Manager to get a Stax merchant with test credentials for Tap to Pay on iPhone testing.

Set up your app for test mode

Use test mode to validate your Tap to Pay on iPhone flow without preparing the app for production distribution yet.

1. Create an InitParams instance with your app ID and API key.
   Java

   var initParams = Omni.InitParams(appId: "appId", apiKey: apiKey)

2. Pass initParams to Omni.initialize() with a completion lambda and an error lambda. Set test to true so the SDK initializes in test mode.
   Java

   omni = Omni()
   testMode = true
   log("Attempting initialization...")
   
   // Initialize Omni with Test flag
   omni?.initialize(params: initParams, test: testMode, completion: {
       // Initialized in test mode!
   }) { (error) in
       // Error initializing test mode
   }

Success looks like the SDK initializing with your test merchant credentials so you can verify your onboarding and payment flows before release.

The Stax-provided testing merchant operates in a LIVE processing environment with a $1 transaction limit. Any transactions processed during testing must be manually refunded or voided.

Request publishing entitlements

When your app is ready for distribution, request production-level entitlements for Apple Tap to Pay. Apple uses this review to confirm that your app follows its Tap to Pay on iPhone user experience requirements.

Steps to request publishing entitlements

1. Review Apple’s Requirements
   Apple evaluates your application against Apple’s User Experience Requirements. Review those requirements before you submit your request so your app is ready for entitlement review.
2. Request Publishing Entitlements
   • Reply to the email through which you received the development entitlements.
     Include your Case ID in the reply. You can find it in the development entitlements email.
   • Apple will respond with further instructions on how to submit your application
     for review.
3. Prepare for the Review Process
   Review Apple’s Entitlements Review documentation, so you know what materials and flows Apple expects during review.

App review

If your app meets Apple’s User Experience Requirements detailed in Appendix B, Apple grants the publishing entitlement. As part of the review, create a video recording of your app completing these flows:

1. New user flow
2. Existing user flow
3. Checkout flow

Use another device to record the video. Tap-to-Pay UI screens on iPhone do not work in screen recordings.

If your app requires changes, Apple communicates them by email.

Once you've received your publishing entitlement and successfully tested Tap to Pay using the Stax-provided testing merchant, please reach out to your Stax Account Manager to schedule a certification call. During this call, we'll review your Tap to Pay flow and, once approved, you'll be ready to submit to the App Store.