{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/hosted-checkout/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"End-to-End Testing","description":"Official Banxa API documentation – on-ramp and off-ramp transfers with identity verification and compliance.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"end-to-end-testing","__idx":0},"children":["End-to-End Testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these steps to validate your complete integration before going to production."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"on-ramp-buy-test-flow","__idx":1},"children":["On-ramp (buy) test flow"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-create-a-buy-order","__idx":2},"children":["1. Create a buy order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/buy"]}," (API integration) or construct your referral URL (Referral integration) with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid test wallet address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A supported crypto and fiat combination"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your sandbox ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify that you receive a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]}," (API) or that your referral URL loads correctly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-open-the-checkout","__idx":3},"children":["2. Open the checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]}," in a browser or via your embedded checkout component."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The checkout loads without errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pre-populated values (wallet address, crypto, fiat, amount) match what you submitted"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-complete-identity-verification","__idx":4},"children":["3. Complete identity verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter test personal details (realistic-looking name, address, date of birth)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If prompted for mobile verification, use:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mobile: any valid-format number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PIN: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["7203"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If prompted for document upload, use test document images."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-complete-payment","__idx":5},"children":["4. Complete payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter test card details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["4111 1111 1111 1111"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Expiry: any future date"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CVV: any 3 digits"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-verify-order-completion","__idx":6},"children":["5. Verify order completion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After completing payment:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm you are redirected to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Look up the order via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/orders/{orderId}"]}," and confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm a webhook was delivered to your configured endpoint with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: \"complete\""]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"off-ramp-sell-test-flow","__idx":7},"children":["Off-ramp (sell) test flow"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-create-a-sell-order","__idx":8},"children":["1. Create a sell order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/sell"]}," with a test wallet address, crypto asset, and fiat currency."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-complete-checkout","__idx":9},"children":["2. Complete checkout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]},". Provide bank account details and complete any required KYC steps."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Non-custodial:"]}," The checkout will display a deposit address. In sandbox, no actual transfer is required — the order will simulate completion."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custodial:"]}," The checkout will return the customer to your platform (via deeplink or webhook, depending on your configuration). Verify that your platform receives the deposit address correctly. In sandbox the order will simulate completion once the flow runs through."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-verify-completion","__idx":10},"children":["3. Verify completion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm the order reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}," status via order lookup or webhook."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-test","__idx":11},"children":["Webhook test"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure a webhook URL in the Partner Dashboard (use webhook.site or ngrok for local testing)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create and complete an order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the webhook is received with the correct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm your endpoint responds with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If using HMAC verification, confirm signature validation passes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"iframe--webview-test","__idx":12},"children":["iFrame / WebView test"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If using embedded checkout:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Load the checkout URL in your iFrame or WebView component."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the checkout renders correctly within your layout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm camera access works (attempt to reach the document upload step)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete a full order flow inside the embedded view."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the WebView/iFrame navigates to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," on completion."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ready-for-production","__idx":13},"children":["Ready for production"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have completed the end-to-end test flow and confirmed all components are working, notify Banxa to enable your production environment."]}]},"headings":[{"value":"End-to-End Testing","id":"end-to-end-testing","depth":1},{"value":"On-ramp (buy) test flow","id":"on-ramp-buy-test-flow","depth":2},{"value":"1. Create a buy order","id":"1-create-a-buy-order","depth":3},{"value":"2. Open the checkout","id":"2-open-the-checkout","depth":3},{"value":"3. Complete identity verification","id":"3-complete-identity-verification","depth":3},{"value":"4. Complete payment","id":"4-complete-payment","depth":3},{"value":"5. Verify order completion","id":"5-verify-order-completion","depth":3},{"value":"Off-ramp (sell) test flow","id":"off-ramp-sell-test-flow","depth":2},{"value":"1. Create a sell order","id":"1-create-a-sell-order","depth":3},{"value":"2. Complete checkout","id":"2-complete-checkout","depth":3},{"value":"3. Verify completion","id":"3-verify-completion","depth":3},{"value":"Webhook test","id":"webhook-test","depth":2},{"value":"iFrame / WebView test","id":"iframe--webview-test","depth":2},{"value":"Ready for production","id":"ready-for-production","depth":2}],"frontmatter":{"title":"End-to-End Integration Testing Guide | Banxa Docs","description":"Step-by-step guide to validate your Banxa integration in sandbox: complete a buy flow, sell flow with confirm endpoint, webhook delivery, and iFrame checkout.","seo":{"title":"End-to-End Testing"}},"lastModified":"2026-05-19T23:30:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/hosted-checkout/docs/testing/end-to-end-testing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}