React SDK
Official SUQO SDK for React (web).
Collect a SUQO payment inline in a React app, where you put the component. Your backend creates a checkout session through SUQO's API and hands your page its id; this package mounts SUQO's own payment block for that id, keeps it the right height, and reports exactly one outcome per attempt.
Source: github.com/suqo-ai/suqo-react · npm: @suqo/react · v0.0.2
No credential in the page. This package makes no SUQO API calls of its own and holds no API key. The session id is the only thing it knows — single-use, short-lived, and carrying no buyer details — so nothing sensitive and nothing long-lived ever sits in your client bundle.
Install
npm install @suqo/reactNo runtime dependencies; ESM and CJS. Peer dependencies: react >=18 (react-dom is an optional peer).
What's included
SUQOCheckout— one component that renders the payment block inline, withonReady,onSuccess,onFailure,onUnavailable,onLoadErrorandonIntentcallbacks.- Exactly one outcome per attempt — the result can arrive by more than one path; the first delivery latches and the rest are dropped.
- Sandbox by default —
modeis'sandbox'unless you say'live', so a page that names neither cannot take a live payment by accident. - Deeplinks handed to you — bank and wallet deeplinks reach your
onIntenthandler; the component never navigates on them.
The session must already have a customer. There is no buyer-detail prop on this component. A session created without a customer reports
onUnavailable('no-customer'). Assign the customer on your backend, through the checkout-session API, before the id reaches the browser.Next
- Usage guide — quick start, environments, outcomes, props and troubleshooting.
- Changelog — what shipped.