Iframe Guidelines

Quick guide to payment method support when embedding xPay Checkout in an iframe.

Quick Reference

Payment Method	Iframe Support	Notes
Card payments	✅ Fully supported	Safe to use in iframe
Apple Pay	❌ Not supported	Requires top-level context
Google Pay	⚠️ Limited support	Needs allow="payment", inconsistent behavior
BNPL (Klarna, Afterpay)	⚠️ Poor UX	Redirects break iframe flow

Key Limitations

Apple Pay

• Cannot work in iframes - Apple requires top-level browsing context
• Solution: Use hosted checkout or open in new window

Google Pay

• Requires allow="payment" attribute on iframe
• Unreliable - browser differences cause inconsistent behavior
• Solution: Test thoroughly or use hosted checkout

BNPL Providers

• Redirect-based flows break iframe experience
• Poor UX - redirects navigate parent window or open new tabs
• Solution: Use hosted checkout for BNPL