Embedded Apple Pay Integration

Apple Pay (S2S) Integration – Overview

Apple Pay (Server-to-Server) integration enables merchants to process Apple Pay transactions directly from their own backend systems. This method provides full control and customization of the Apple Pay experience, allowing advanced checkout flows, custom UI, and seamless user interactions.

Unlike the Embedded Integration (Checkout) approach — where EdfaPay handles the Apple Pay button and session on behalf of the merchant — the S2S integration requires merchants to handle everything from session creation to payment processing. This includes domain verification, Apple certificates, and secure transmission of Apple Pay tokens.

💡
Use Case This integration is best suited for merchants who want to build a custom checkout experience on their website or mobile app, and have the technical resources to manage certificate handling and backend integration.

Integration Steps

To integrate Apple Pay S2S, you’ll need to:

Set up your Apple Merchant ID and certificates via your Apple Developer account.
Register and verify your domain with Apple.
Configure Apple Pay on MPGS (if you're using it).
Implement merchant validation and session generation.
Render Apple Pay button and process the payment request.

Integration Flow

Step 1: Customer Selection

Customer selects Apple Pay from your checkout page.

Step 2: Apple Pay Sheet

Apple Pay sheet opens (Safari/iOS/macOS).

Step 3: Token Generation

Apple generates a payment token after customer authorization.

Step 4: Frontend to Backend

Your frontend sends the token to your backend.

Step 5: Backend to EdfaPay API

Your backend calls EdfaPay S2S API with the Apple Pay token.

Step 6: Payment Processing

EdfaPay processes the payment with the issuer via MPGS.

Step 7: Status Return

Payment status is returned to your backend.

Production Only:
Apple Pay S2S cannot be tested in Sandbox. Domain verification is only valid for production domains.

Certificate Expiry:
The payment processing certificate expires annually — set reminders to renew before expiry to avoid downtime.

Safari Support:
On the web, Apple Pay works only in Safari; in mobile, it works only in iOS apps or Safari browser.