Apple Pay Payment Flow

Integration Mode Differences

The key difference between integration modes is the merchant validation process:

• Merchant-Owned: Uses the merchant's Merchant Identity certificate for direct Apple Pay validation
• Onerway Proxy: Uses Onerway's Merchant Identity certificate through proxy validation
• Payment Authorization: Both modes use identical flows after onpaymentauthorized

Configuration Loading Options:

• Preload (recommended): Fetch payment configuration when page loads for faster button response
• On-demand: Fetch configuration when user taps Apple Pay button to reduce unnecessary requests

See also: Integration Setup · Session Initialization · Merchant Validation · Payment Authorization · Troubleshooting

Merchant-Owned Mode

Onerway Proxy

References & Related Topics

• Integration Setup: Certificates and domain preparation — see Integration Setup.
• Session Initialization: Load Apple Pay JS, canMakePayments(), button display — see Session Initialization.
• Merchant Validation: onvalidatemerchant → completeMerchantValidation() — see Merchant Validation.
• Payment Authorization: onpaymentauthorized → completePayment — see Payment Authorization.
• Troubleshooting: Common errors and guidance — see Troubleshooting.