Skip to content

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 /v1 with x-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 formatEventHoursParts from 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