> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpaycheckout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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