The Banxa React Native SDK wraps Banxa Hosted Checkout in a TypeScript-first mobile SDK. Install a single package, configure it with your API key, and call typed methods to fetch quotes, create orders, and present the checkout — all inside your mobile app.
This is the fastest way to integrate Banxa Hosted Checkout into a React Native mobile app. Authentication uses the same x-api-key header as the API; no backend is required for core flows.
Choose the SDK if:
- You're building a React Native mobile app.
- You want faster time to integration than wiring up API calls manually.
- You want a type-safe interface with typed request and response models.
- You want the SDK to handle WebView presentation, navigation events, and return URL detection.
For some capabilities, you'll need the API integration path directly — either alongside the SDK, or as your primary integration path:
| Capability | Path |
|---|---|
| Web apps | Referral integration (JS SDK) or API integration |
| KYC data sharing (Sumsub token share) | API integration — uses HMAC auth, which the SDK does not support |
| Full order list across all customers | GET /v2/orders via API integration — the SDK supports lookup by ID or customer only |
| Referral (JS SDK) | API | React Native SDK | |
|---|---|---|---|
| Integration effort | Lowest | Highest | Low |
| Platform | Web | Any | React Native mobile |
| Backend required | No | No (only for KYC sharing) | No |
| Webhooks | No | Yes | Yes (configured separately) |
| Order lookup | No | Yes (all orders) | Yes (by ID or by customer) |
| KYC sharing | No | Yes | No |
| Quote UI in your app | No | Yes | Yes |
| Checkout presentation | Redirect or iFrame | You choose | In-app WebView |
- SDK Integration Guide — end-to-end walkthrough with code.
- SDK Reference — full method reference.