React checkout
Embed guide
Partner-hosted React import is the primary embed path.
Reference
Copy the prop shape from Quickstart. Do not invent a
thinner API than CheckoutSpineRoot documents.
Rules
- Inline checkout is the default. Modal-only checkout as the primary path is wrong.
- Your server proxies Partner
/v1withx-api-key. Embed does not work without a BFF. - Do not iframe hosted checkout. Hosted AXYN pages send
frame-ancestors 'none', so a frame stays blank. - Keep hard-floor UI (totals, skip paths, powered-by policy) intact.
- Host owns catalog loading and payment return navigation.
- Event hours: use
formatEventHoursPartsfrom this package so duration matches hosted AXYN. We compute length from the start and end you already set. See Hours and duration.
Aggregators
Aggregators embed the same spine. Branding and Powered by AXYN requirements are
in Theming. Public aggregator go-live is white-glove — see the
portal /aggregators page.
After pay
Checkout ends at confirmation. Guests open a live pass (hosted by default,
or BearerTicketScreen if you embed the ticket UI). Send a pass / claim is on
the pass, not checkout. Upgrade uses UpgradeFlow on the same Live Pass
URL. See Ticket delivery, Live pass,
Transfer, and Upgrade.
Next
- Quickstart
- Checkout spine
- Theming
- Anti-patterns
- Ticket delivery
- Live pass
- Upgrade
- Headless API if you need full custom UI instead