Apple Pay

Apple Pay allows customers to complete Shoppable Ads purchases using Apple Pay directly within the Rokt placement. The Rokt SDK handles Apple Pay session creation, payment sheet presentation, and payment processing. The Rokt Catalog brand is the Merchant of Record (MoR).

Apple Pay is supported on web and iOS, with additional platform support planned.

Sequence overview

1. Placement loads. After the customer completes their transaction, the Rokt Shoppable Ads placement renders on the confirmation page.
2. Eligibility check. The Rokt SDK determines whether Apple Pay is available on the customer's device. If not supported, the placement falls back to other eligible payment methods (e.g., card forwarding).
3. Offer displayed. The placement displays the offer with the appropriate payment CTA based on available payment methods.
4. Customer taps "Pay with Apple Pay". The Apple Pay payment sheet is presented, showing item details, price (including tax and shipping), and the brand's merchant name.
5. Customer authorizes. The customer authenticates via Face ID, Touch ID, or device passcode.
6. Payment processed. Rokt processes the payment with the brand as MoR. A confirmation screen is displayed within the placement.
7. Placement closes. The partner's standard post-confirmation flow continues.

NOTE: If no eligible offer is available or no supported payment method is detected, the placement closes without displaying an offer.

Required attributes

Apple Pay uses the standard attributes passed during SDK initialization. For the full list, see the recommended attributes in the SDK Integration Guide.

The following attribute is used for Apple Pay payment method selection:

Attribute	Type	Required	Description
payment_type	string	Yes	The payment method the customer used for their original transaction (e.g., visa, mastercard, amex, apple_pay, paypal). Rokt uses this to determine payment method priority. If the customer paid with Apple Pay, it is shown as the primary CTA.

NOTE: If your platform does not have shipping address details available (e.g., ticket or digital goods purchases), pass billing address details instead. Rokt will provide a UI for the customer to confirm or edit their shipping address before completing the purchase.

Web setup

Rokt manages domain registration, merchant configuration, and payment processing for Apple Pay end-to-end. Partners using SDK+ do not need any additional setup. Partners on the legacy SDK must enable the Apple Pay extension as described below.

SDK extensions (Legacy SDK only)

If you are using the legacy Rokt Web SDK (launcher.js), add payments-stripe-applepay to the extensions query parameter when loading the SDK script. If you also use card forwarding, include both extensions:

script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js?extensions=instant-purchase,payments-stripe-applepay";

• payments-stripe-applepay - enables Apple Pay as a payment method on Shoppable Ads placements.
• instant-purchase - enables card forwarding as a payment method on Shoppable Ads placements.

NOTE: If you are using SDK+ (versions after 2.5926.0), extensions are enabled automatically and no script changes are required.

Browser and device compatibility

Browser	Platform	Apple Pay Support	Notes
Safari 17+	iOS 17+, macOS 12+	Supported	Native Apple Pay.
Safari (older)	iOS, macOS	Limited	Same-origin only.
Chrome	iOS	Supported	Apple Pay is device-based on iOS. Works the same as Safari.
Chrome	Desktop (macOS)	Not supported	Rokt falls back to other payment methods.
Chrome / Firefox	Windows, Android	Not supported	Rokt falls back to other payment methods.

Rokt automatically detects browser and device compatibility and will only display the Apple Pay button where it is supported. No additional gating logic is required from the partner.

NOTE: Shoppable Ads placements are typically rendered directly on the page, not within an iframe. This is required for Apple Pay to function correctly. If your integration renders the Rokt placement inside an iframe, contact your Rokt account manager to discuss additional configuration requirements.

iOS setup

The steps below configure Apple Pay for any iOS-based integration (native iOS, React Native, Flutter, etc.). After completing these steps, return to your SDK integration guide to register the payment extension.

Create a Merchant ID

1. Sign in to the Apple Developer Portal.
2. Under Identifiers, select Merchant IDs from the dropdown.
3. Click the + button to register a new merchant identifier.
4. Enter a description (e.g., "Rokt Apple Pay") and a unique identifier dedicated to Rokt (e.g., merchant.com.yourapp.rokt).
5. Click Continue, then Register.

注記

Create a new merchant ID dedicated to Rokt. If your app already uses Apple Pay for its own checkout, do not reuse that merchant ID — each merchant ID supports only one Payment Processing Certificate, and uploading Rokt's CSR would overwrite your existing certificate.

For more details, see Apple's Setting up Apple Pay guide.

Enable Apple Pay in Xcode

1. Open your project in Xcode and select your app target.
2. Go to the Signing & Capabilities tab.
3. Click + Capability and add Apple Pay.
4. Select the merchant ID you created (e.g., merchant.com.yourapp.rokt) from the list.

If the merchant ID does not appear, ensure your Apple Developer account is linked in Xcode under Settings > Accounts.

Generate a Payment Processing Certificate

1. Request a Certificate Signing Request (CSR) from Rokt — your Rokt account manager will provide a CSR generated from Stripe.
2. In the Apple Developer Portal, select your merchant ID.
3. Under Apple Pay Payment Processing Certificate, click Create Certificate.
4. Upload the CSR file provided by Rokt.
5. Download the generated .cer file and share it with your Rokt account manager.

注意

The Payment Processing Certificate expires every 25 months. Apple will send expiration reminders to your Apple Developer account email. When renewing, request a new CSR from your Rokt account manager and repeat the steps above.

Checklist

Web

• If using the legacy SDK: payments-stripe-applepay added to the extensions query parameter
• payment_type attribute passed on every Rokt experience launch
• End-to-end testing completed on Safari 17+ (iOS or macOS)

iOS

• Merchant ID created in the Apple Developer Portal
• Apple Pay capability added in Xcode with the correct merchant ID
• Payment Processing Certificate generated and shared with Rokt
• Payment extension registered in your SDK integration (see your SDK guide: iOS | React Native)
• End-to-end testing completed on a physical iOS device