Skip to main content
This guide provides a comprehensive process to integrate Apple Pay with Yuno SDK for both one-time and recurring payments. The SDK simplifies Apple Pay integration by handling payment token management and providing built-in security.
Setup RequiredBefore implementing Apple Pay payments, ensure you have completed the prerequisites.
Testing EnvironmentApple Pay is not supported in the iOS Simulator. To test Apple Pay functionality, you must use a physical iOS device.
Apple Pay on the web is not limited to Safari or Apple devices. It also works in third-party browsers on iPhone, iPad, and macOS, and in any browser on Windows through Apple’s cross-device payment flow. See Supported devices and browsers for the full matrix.
Cross-Origin Iframe Embedding (Web SDK 1.11.31+)When embedding checkout in an iframe hosted on a different domain, Safari requires validating the Apple Pay merchant session against the top-level parent page domain. The Web SDK detects this automatically. The top-level domain must be registered on the Apple Pay connection, otherwise the session falls back to the iframe domain. You can explicitly specify the parent domain or disable detection using externalButtons.applePay.topLevelDomain. See the Web SDK reference.

​
Apple Pay overview

  1. Customer initiates payment on their iOS device
  2. Receive payment_token via Apple SDK
  3. Create a checkout session with Yuno
  4. Yuno processes with your configured provider(s) and returns a response
  5. Monitor response status via webhooks

​
Add Apple Pay capability

To add Apple Pay capability to your iOS app:
  1. In Xcode, select your project in the navigator
  2. Select your app target
  3. Go to the Signing & Capabilities tab
  4. Click + Capability and search for “Apple Pay”
  5. Add the Apple Pay capability
  6. Configure your Merchant IDs in the Apple Pay section
Ensure your Apple Pay Merchant ID matches the one configured in your Yuno Dashboard provider connections.

​
One-time payments with SDK

​
Create checkout session

Use the create checkout session endpoint to create a payment session for one-time Apple Pay transactions:

​
Process the payment

The SDK handles the Apple Pay flow automatically. When the customer completes the Apple Pay authorization, the payment is processed immediately.

​
Requesting Contact Information

You can configure which contact fields Apple Pay requests from the customer directly from the Checkout Builder. The available fields are:
  • Email
  • Phone
  • Holder name
  • Billing address
  • Shipping address
When any of these fields are enabled as required in the Checkout Builder, the Apple Pay payment sheet will prompt the customer to provide or confirm that information before completing the payment. The collected data is then included in the OTT response.
Each additional required field adds an extra step to the Apple Pay payment sheet, increasing friction for the customer. This can negatively impact conversion rates. Yuno recommends enabling only the fields that are strictly necessary for your business or regulatory requirements.
Holder name (cardholder name) is disabled by default for Apple Pay, unlike cards, where it’s enabled by default. Enable it from the Checkout Builder if your integration needs it.

​
Next steps

  • Recurring payments. Customer-initiated and merchant-initiated transactions with a vaulted token.
  • Express checkout. Order breakdown, shipping methods and shipping address updates on the payment sheet.
  • Card filters and good to know. Filter eligible cards, read the DPAN BIN from the one-time token and handle cancellations.