{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/hosted-checkout/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Android SDK Integration Guide","description":"Official Banxa API documentation – on-ramp and off-ramp transfers with identity verification and compliance.","llmstxt":{"title":"Banxa Developer Documentation","description":"Integrate crypto-fiat exchange with Banxa's licensed infrastructure: payments, KYC, compliance, and settlement handled. 150+ countries, 45 global licences.","details":{"content":"Two integration products: **Banxa Native API** for partners who manage their own KYC and want full UX control (headless, HMAC server-to-server, no Banxa-hosted screens); **Banxa Hosted Checkout** for partners who want Banxa to handle KYC and payments (three paths: Referral URL, API, or React Native SDK). Both use the same sandbox and production environments at `https://api.banxa-sandbox.com` and `https://api.banxa.com`.\n\n## Constraints\n\n- **Authentication**: HMAC credentials must be stored server-side only, never expose in frontend, mobile, or client-side code. HMAC is required for all Native API calls and for KYC sharing in Hosted Checkout; `x-api-key` is used for all other Hosted Checkout endpoints.\n- **`externalCustomerId`**: Required on every buy and sell order. Use a stable opaque identifier, never PII.\n- **`identityReference`**: Must remain constant for the same user across all requests. Must not contain PII. If you attempt to create an identity for an email that already exists, you will receive a 422 / code 81, so retrieve the existing record rather than retrying creation. Use `GET /eapi/v0/identities/{identityReference}?email=user@example.com` to look up the real `identityReference` linked to an email.\n- **`quoteId`**: Only supported by `POST /eapi/v0/ramps` (bank transfer). The React Native SDK and Embedded Payment Button do not accept a `quoteId`, so use indicative pricing (`GET /eapi/v0/price`) for SDK and Embedded Payment Button flows.\n- **Quotes**: Indicative prices are not rate-locked, so refresh close to order creation to minimise rate drift. Locked quotes (`GET /eapi/v0/quote`) expire after approximately 3 minutes and are only valid for bank transfer ramp creation.\n- **Eligibility gate**: Never create a ramp or invoke the SDK when `paymentReady` is `false`. Always check eligibility and satisfy all requirements before payment execution.\n- **Webhooks**: Verify all inbound webhook signatures with HMAC-SHA256 before processing. Return HTTP 200 immediately and process asynchronously.\n- **Product selection**: Banxa Native is for partners who manage their own KYC. Banxa Hosted Checkout is for partners who do not do KYC. These are separate products with separate flows: do not mix endpoints across products.\n- **SDK scope**: The React Native SDK has no `banxa.customerIdentity` module. Identity and KYC are handled through the Native API only. `primerCallbacks` and `primerSettings` are Native context only and must not be referenced in Hosted Checkout integrations.\n- **Payment method naming**: Never use \"eAPI\" or \"EAPI\" as a product name. The correct name is \"Banxa Native API\". The URL path prefix `/eapi/` is correct and should not be changed.\n"}}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"android-sdk-integration-guide","__idx":0},"children":["Android SDK Integration Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks through a complete Banxa Hosted Checkout integration in a native Android app using the Banxa Android SDK. By the end you will have a working buy flow: initialise the SDK once, render the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["StartPayment"]}," composable when the customer confirms, and confirm the final order status from your backend."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Android SDK is headless and Compose-first. There is no Banxa Activity to launch and no WebView for you to manage. You supply an order request and callback lambdas, and the SDK presents checkout and reports the outcome."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full API surface, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/sdk-integration/android-sdk-reference"},"children":["Android SDK Reference"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A native Android app on API level 24 or above, using Kotlin 2.0 or above with the Compose Compiler Gradle plugin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Jetpack Compose enabled in your project. The SDK's payment entry point is a composable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your Banxa partner reference and API key. Use sandbox for development, production after approval."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A configured webhook endpoint. Optional but recommended for order status tracking."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"install-the-sdk","__idx":3},"children":["Install the SDK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Android SDK is distributed as an AAR. Copy it into your module's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["libs"]}," directory and reference it from your Gradle build file."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"dependencies {\n    implementation(files(\"libs/BanxaPayment-1.0.0.aar\"))\n}\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"AAR distribution"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Android SDK is not currently published to a Maven repository, so it does not resolve by coordinate and does not update through your dependency manager. Contact Banxa to obtain the AAR and to be notified when a new version is released."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-initialise-the-sdk","__idx":4},"children":["Step 1: Initialise the SDK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Build a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BanxaConfig"]}," and initialise once at app launch."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"val config = BanxaConfig.Builder()\n    .apiKey(\"YOUR_API_KEY\")\n    .partnerID(\"your-partner-id\")\n    .environment(Environment.SANDBOX)\n    .build()\n\nBanxa.initialize(config)\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your v2 API key from the merchant dashboard."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partnerID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your partner identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Environment.SANDBOX"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Environment.PRODUCTION"]},". Credentials are not interchangeable."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-get-a-quote","__idx":5},"children":["Step 2: Get a quote"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fetch live pricing before you show an amount to the customer. Call this close to when the price is displayed, because crypto rates move quickly and quotes are indicative."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"val repository = BanxaRepository(\n    RetrofitClient.getApi(config.baseUrl, config.environment)\n)\n\nval result = repository.getQuote(\n    partner = config.partner,\n    apiKey = config.apiKey,\n    orderType = \"buy\",\n    request = QuoteRequest(\n        fiat = \"AUD\",\n        crypto = \"ETH\",\n        blockchain = \"ETH\",\n        paymentMethodId = \"debit-credit-card\",\n        fiatAmount = \"200\"\n    )\n)\n\nresult.onSuccess { quote ->\n    println(\"Pay ${quote.fiatAmount}, receive ${quote.cryptoAmount}\")\n    println(\"Fees: processing=${quote.processingFee}, network=${quote.networkFee}\")\n}\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiatAmount"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cryptoAmount"]},". Quotes carry no quote id, so there is nothing to pass into the payment call."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the same repository to populate your currency and payment method selectors at runtime rather than hardcoding values. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/sdk-integration/android-sdk-reference"},"children":["Android SDK Reference"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-start-the-payment","__idx":6},"children":["Step 3: Start the payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Render the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["StartPayment"]}," composable when the customer confirms."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"StartPayment(\n    createOrderRequest = CreateOrderRequest(\n        fiat = \"EUR\",\n        crypto = \"ETH\",\n        fiatAmount = \"40\",\n        cryptoAmount = null,\n        walletAddress = \"0x0000000000000000000000000000000000000000\",\n        redirectUrl = \"your-app-scheme://banxa-return\",\n        paymentMethodId = \"debit-credit-card\",\n        email = \"user@example.com\"\n    ),\n    banxaDidReceiveCheckout = { result ->\n        // Payment succeeded. Confirm the authoritative state from your backend.\n    },\n    banxaDidFail = { error ->\n        // API, validation, network, decoding, or checkout failure.\n    },\n    banxaDidDismiss = {\n        // The customer closed checkout without completing.\n    }\n)\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"required-fields","__idx":7},"children":["Required fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiat"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crypto"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiatAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The order amounts and assets."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMethodId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment method to use."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer's receiving wallet address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer's email address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the customer returns after checkout."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalCustomerId"]}," as well. It is your stable per-customer identifier, and Banxa uses it to recognise returning customers so they do not repeat KYC."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Do not create orders in advance"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["StartPayment"]}," creates the order and presents checkout together, which keeps the order inside the one-minute window in which Banxa checkout must be loaded. Render it at the moment the customer confirms. There is no supported pattern for creating an order early and presenting it later."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"A missing memo can permanently lose funds"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["XRP, XLM, EOS, and ATOM require a memo or tag. Pass it as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletAddressTag"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreateOrderRequest"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-handle-the-outcome","__idx":8},"children":["Step 4: Handle the outcome"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All three callbacks have a default no-op implementation, so supply only what you need."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Callback"},"children":["Callback"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Fires when"},"children":["Fires when"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["banxaDidReceiveCheckout"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer completed payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["banxaDidFail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Any Banxa, network, validation, or checkout failure."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["banxaDidDismiss"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer closed checkout without completing."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["banxaDidReceiveCheckout"]}," is a UI signal, not the authoritative order state. Do not credit the customer on it."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-confirm-order-status","__idx":9},"children":["Step 5: Confirm order status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK does not expose order lookup. Confirm the final state from your backend using the Banxa API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only terminal statuses are final. Do not credit the customer until the order reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]},". For the full list, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/order-statuses"},"children":["Order Statuses"]},", and for lookup see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/order-lookup"},"children":["Order Lookup"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-6-handle-webhooks","__idx":10},"children":["Step 6: Handle webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Webhooks fire on every order status change and are the reliable mechanism for order tracking. Configure your webhook URL in the merchant dashboard."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The typical pattern:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Success callback: optimistic UI update, \"your order is processing\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook to your backend: authoritative order state."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Backend pushes the update to the app, or the app re-fetches on resume."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/webhooks"},"children":["Webhooks"]}," for payload structure and signature verification. Webhook signatures are verified with your HMAC secret, not the v2 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-api-key"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"google-pay-approval","__idx":11},"children":["Google Pay approval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When your Android app presents Google Pay, Google requires app-level approval before you can process live payments. Banxa holds Google Pay approval for its own website, and that approval applies only when the customer is redirected to an external browser or a Custom Chrome Tab, not when Google Pay is presented inside your app."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start the approval process early. It is the most common cause of a delayed Android launch."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"kyc-camera-access","__idx":12},"children":["KYC camera access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Banxa runs KYC inside the checkout the SDK presents. Declare ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["android.permission.CAMERA"]}," in your manifest and request it at runtime before the customer reaches verification. Without it, document capture fails and the customer cannot complete KYC."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"testing","__idx":13},"children":["Testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use sandbox for all development:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"kotlin","header":{"controls":{"copy":{}}},"source":"val config = BanxaConfig.Builder()\n    .apiKey(\"YOUR_SANDBOX_API_KEY\")\n    .partnerID(\"your-partner-id\")\n    .environment(Environment.SANDBOX)\n    .build()\n\nBanxa.initialize(config)\n","lang":"kotlin"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Google Pay can be tested on a physical Android device or on an emulator with Google Play Services installed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For test credentials, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/testing/sandbox-test-data"},"children":["Sandbox Test Data"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"native-payment-sheet","__idx":14},"children":["Native payment sheet"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK presents a native payment sheet for card and Google Pay when the customer is cleared for it, and falls back to Banxa checkout when they are not. Driving that behaviour explicitly, including reading the eligibility result and acting on outstanding requirements, is a Banxa Native capability for partners who verify their own users and run their own KYC. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://banxa-enterprise.redocly.app/enterprise-api/v0-beta"},"children":["Banxa Native"]},", or talk to Banxa about whether it is relevant to your integration."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":15},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/sdk-integration/android-sdk-reference"},"children":["Android SDK Reference"]},": full method, model, and error reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/webhooks"},"children":["Webhooks"]},": configure webhook notifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/transaction-lifecycle/order-statuses"},"children":["Order Statuses"]},": full status reference."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/testing/sandbox-test-data"},"children":["Sandbox Test Data"]},": credentials and test values."]}]}]},"headings":[{"value":"Android SDK Integration Guide","id":"android-sdk-integration-guide","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Install the SDK","id":"install-the-sdk","depth":3},{"value":"Step 1: Initialise the SDK","id":"step-1-initialise-the-sdk","depth":2},{"value":"Step 2: Get a quote","id":"step-2-get-a-quote","depth":2},{"value":"Step 3: Start the payment","id":"step-3-start-the-payment","depth":2},{"value":"Required fields","id":"required-fields","depth":3},{"value":"Step 4: Handle the outcome","id":"step-4-handle-the-outcome","depth":2},{"value":"Step 5: Confirm order status","id":"step-5-confirm-order-status","depth":2},{"value":"Step 6: Handle webhooks","id":"step-6-handle-webhooks","depth":2},{"value":"Google Pay approval","id":"google-pay-approval","depth":2},{"value":"KYC camera access","id":"kyc-camera-access","depth":2},{"value":"Testing","id":"testing","depth":2},{"value":"Native payment sheet","id":"native-payment-sheet","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Android SDK Integration Guide | Banxa Docs","description":"End-to-end Android integration for Banxa Hosted Checkout with the Banxa Android SDK: install the AAR, initialise, render StartPayment, handle callbacks, and confirm order status.","seo":{"title":"Android SDK Integration Guide"}},"lastModified":"2026-08-12T00:56:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/hosted-checkout/docs/sdk-integration/android-sdk-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}