@sigworld/sdk-ui is the recommended presentation layer. It owns wallet connection, quotes, asset selection, payment signing, submission, and order status display after checkout opens. For recurring payments, use the separate Subscription SDK UI guide. It uses SixpaySubscriptionModal, a published subscription product, and subscription lifecycle webhooks rather than a one-time checkout session.

React

Do not pass title, description, order amount, or merchantOrderId when using a checkout session. SDK UI reads the safe session snapshot and displays the line items in its order area.

Browser bundle

The global bundle has the equivalent SiXPay.createCheckout({ checkoutSessionId, checkoutToken }) API. Controllers expose open, close, and unmount.

Responsibilities

  • Keep the merchant’s button focused on opening checkout. Do not show wallet readiness there.
  • Let SDK UI show wallet preparation, connection, and payment states inside its modal.
  • Keep browser session credentials transient.
  • Use a verified webhook to complete the merchant order.
For Privy and wallet switching, see wallets.