Apple Pay
Configure Apple Pay for your Plexy integration on web and iOS
Apple Pay lets your shoppers pay with the cards stored in their Apple Wallet, using Face ID, Touch ID, or a passcode to authorise. Enabling Apple Pay with Plexy is a one-time setup in your dashboard at Settings → Integrations, plus per-platform steps below.
Web setup
For Apple Pay on the web you only need to validate the domain you serve checkout from. Plexy holds the merchant identity certificate, so no certificate upload happens on the web side.
In the Plexy dashboard at Settings → Integrations, click Download domain association file. This downloads apple-developer-merchantid-domain-association (no file extension).
Serve the file at:
https://<your-domain>/.well-known/apple-developer-merchantid-domain-associationThe file must be reachable over HTTPS, without redirects, and without an added extension.
Back in the Plexy dashboard, type the same domain into the Domain verification input and click Verify. On success, click Register. The domain now appears under Registered domains.
Each domain that serves your Apple Pay checkout must be registered. Subdomains
count separately — register www.example.com and checkout.example.com if
both serve checkout.
Once the domain is registered, the Plexy Web SDK renders the Apple Pay button automatically.
Native setup (iOS)
Prerequisites
- An Apple Developer Program membership.
- Access to the Plexy dashboard's Settings → Integrations page (requires a store).
For native iOS apps you'll generate a Certificate Signing Request (CSR) in the Plexy dashboard, sign it with Apple, then upload the resulting .cer back to Plexy. This binds your Apple Merchant ID to Plexy so the SDK can decrypt payment tokens.
In Apple Developer →
Identifiers,
create a new Merchant ID (for example, merchant.com.yourbrand.app).
In Settings → Integrations → Apple Pay certificates, enter a label, then
click Generate CSR. The dashboard downloads a .csr file and adds a new
certificate row in pending status.
On your Merchant ID's page in Apple Developer, click Create Certificate
under Apple Pay Payment Processing Certificate, upload the .csr, then
download the signed .cer Apple returns.
Back in the Plexy dashboard, on the pending certificate row, click Upload
certificate and select the .cer. The row moves to active once Plexy
verifies it.
In Xcode, open your target's Signing & Capabilities, add the Apple Pay capability, and select the same Merchant ID. The Plexy iOS SDK reads the Merchant ID from your app and uses the certificate Plexy now holds to decrypt payment tokens.
Apple Pay is not available on Android. For Android, see Google Pay.
iOS SDK →
Render Apple Pay in your iOS app with Drop-in or Components.
React Native SDK →
Apple Pay on iOS via the Plexy React Native wrapper.
Flutter SDK →
Apple Pay on iOS via the Plexy Flutter wrapper.
Troubleshooting
Domain verification fails with 404. The file must be served at the exact
.well-known/apple-developer-merchantid-domain-association path, over HTTPS,
without a redirect and without an added extension.
Certificate stuck in pending. The uploaded .cer must be signed against
the CSR Plexy generated. If the row never moves to active, generate a fresh
CSR in Plexy and re-issue the certificate in Apple Developer.
iOS app does not present the Apple Pay sheet. Confirm the Apple Pay capability is enabled in Xcode and the selected Merchant ID matches the one tied to your active certificate in Plexy.