# SDK Integration Overview

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.

## When to use the SDK

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](/products/hosted-checkout/docs/referral-integration/overview) (JS SDK) or [API integration](/products/hosted-checkout/docs/api-integration/api-integration-overview) |
| KYC data sharing (Sumsub token share) | [API integration](/products/hosted-checkout/docs/api-integration/api-integration-overview) — uses HMAC auth, which the SDK does not support |
| Full order list across all customers | `GET /v2/orders` via [API integration](/products/hosted-checkout/docs/api-integration/api-integration-overview) — the SDK supports lookup by ID or customer only |


## How it compares

|  | 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 |


## Next steps

- [SDK Integration Guide](/products/hosted-checkout/docs/sdk-integration/integration-guide) — end-to-end walkthrough with code.
- [SDK Reference](/products/hosted-checkout/docs/sdk-integration/sdk-reference) — full method reference.