Apple Pay
Apple Pay Web enables secure, convenient payments through Apple's ecosystem, supporting Touch ID and Face ID authentication methods. This integration guide covers both enterprise and simplified implementation strategies.
Quick Navigation
- 🚀 Quick Decision Guide - Choose your integration path in 2 minutes
- 📋 Integration Mode Comparison - Detailed feature comparison
- 🔍 Payment Flow - End-to-end payment flow diagrams (with Mermaid sequence diagrams)
- 🔧 Integration Setup - Certificate setup and domain verification (detailed explanation of both modes)
- 💻 Implementation Guide - Step-by-step development process
- 🛠 Troubleshooting - Error handling and debugging
Quick Decision Guide
Choose your Apple Pay integration approach based on your organization type:
🎯 For Enterprise Organizations:
- Have existing Apple Developer account? → Merchant-Owned Account Mode
- Need full certificate control? → Merchant-Owned Account Mode
- Managing multiple domains? → Merchant-Owned Account Mode
🚀 For Simple Integration:
- No Apple Developer account? → Onerway Proxy Mode
- Want simplified setup? → Onerway Proxy Mode
- Prefer centralized maintenance? → Onerway Proxy Mode
Apple Pay Integration Overview
Apple Pay Web integration follows a structured four-phase workflow:
Integration Phases
Phase 1: Integration Setup
- Certificate setup and management
- Domain registration and verification
- Security requirements validation
Phase 2: Session Initialization
- Device support detection
- Payment configuration retrieval
- UI preparation and button display
Phase 3: Payment Initiation
- ApplePaySession creation
- Payment request construction
- Payment sheet display
Phase 4: Payment Authorization
- Merchant validation
- Payment processing
- Transaction completion
Complete Flow Overview
See the Payment Flow documentation for complete end-to-end payment flows, including detailed sequence diagrams for both Merchant-Owned and Onerway Proxy modes.
Integration Mode Comparison
| Aspect | Merchant-Owned Account Mode | Onerway Proxy Mode |
|---|---|---|
| Setup Complexity | Advanced certificate management | Simplified domain verification |
| Apple Developer Account | Required | Not required |
| Certificate Control | Full self-management | Centralized by Onerway |
| Domain Management | Direct Apple registration | Onerway-managed registration |
| Maintenance | Self-managed renewals | Automated maintenance |
| Best For | Enterprise organizations | SMBs and rapid deployment |
Implementation Workflow
Mode Selection Process
🎯 Merchant-Owned Account Mode
For enterprises with Apple Developer accounts requiring full control:
- Prerequisites: An active Apple Developer account and technical team
- Setup Process: See detailed Integration Setup Guide
- Certificate Management: Self-managed payment processing and merchant identity certificates
- Domain Control: Direct Apple Developer console registration and verification
🚀 Onerway Proxy Mode
For simple integration without Apple Developer requirements:
- Prerequisites: HTTPS-enabled domain with A-grade SSL rating
- Setup Process: Domain submission to Onerway technical team
- Certificate Management: Centralized by Onerway infrastructure
- Domain Control: Onerway-managed registration with automated verification
Development Process
Environment Setup
- Complete certificate setup (see Integration Setup)
- Verify domain requirements and SSL compliance
- Configure development and staging environments
Frontend Integration
- Implement device support detection (see Session Initialization)
- Create ApplePaySession with proper parameters (see Payment Initiation)
- Handle user interaction and payment sheet display
Backend Integration
- Configure merchant validation endpoints
- Implement payment processing with Onerway APIs
- Set up webhook handlers for async notifications
Testing & Deployment
- Test across supported devices and browsers
- Validate error handling scenarios (see Troubleshooting)
- Execute end-to-end payment flow validation
Technical Requirements
To avoid duplication, technical requirements and setup validation are unified in Integration Setup:
- Security Requirements — see Integration Setup
- Common Issues — see Apple Pay Troubleshooting