Checkout popup

Payers pay in a 400×720 hosted window. They never create a Bytix account.

Size

Always open checkout as a popup, not a tab and not an iframe. The helper requests 400×720. Browsers drop the requested size if window.open runs after an await. Call the helper in the same click handler, then await your backend, then navigate the popup.

Helper

Load http://127.0.0.1:43123/merchant-popup.js. GatewayCheckout.begin() opens a blank window; go(checkout_url) loads the hosted page. If you already have the URL (no await), GatewayCheckout.open(checkout_url, options) opens and navigates in one step.

• onPaid fires on a bytix.deposit.paid postMessage.
• onCancelled fires on bytix.deposit.cancelled.
• If the popup is blocked, begin() returns a no-op go and popup: null.

Branding

The popup shows your workspace name, logo, amount, and countdown. Set name and logo under Settings → Merchant. Allowed assets, language, default success/cancel URLs, and pay tolerances live under Settings → Checkout.

Expiry

Per-order expiry is valid_time (minutes, 10–1440) or expires_in on create. If omitted, the merchant default timeout from Checkout settings is used. Querying an open order after that time marks it expired and emits order.expired.