{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/hosted-checkout/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Checkout Visualisation: iFrame vs. Redirect","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":"checkout-visualisation-iframe-vs-redirect","__idx":0},"children":["Checkout Visualisation: iFrame vs. Redirect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Banxa checkout is a sequence of screens that guides your customer through their crypto transaction — identity verification, payment details, and order confirmation. You choose how that checkout is presented to them."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"redirect","__idx":1},"children":["Redirect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The customer is redirected to a Banxa-hosted checkout page, either in a new tab or the same window."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How it works:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your app generates a checkout URL (via Referral link or the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]}," returned in an API order response)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The customer is redirected to that URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Banxa handles the entire checkout experience."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On completion, the customer is redirected back to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advantages:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Least integration effort — no embedding or WebView configuration required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The checkout page can be co-branded with your logo and styling."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fully compatible with all payment methods including Apple Pay and Google Pay."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The customer visibly leaves your application."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Less control over the in-app experience."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"embedded-checkout-iframe","__idx":2},"children":["Embedded Checkout (iFrame)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Banxa checkout is embedded inside your application using an iFrame (web) or WebView (mobile)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How it works:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your app generates a checkout URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The URL is loaded inside an iFrame or WebView component in your UI."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The customer completes the transaction without leaving your app."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advantages:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Seamless experience — the customer stays within your product."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Greater control over layout and context around the checkout."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Considerations:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Requires additional WebView configuration on mobile (camera access, local storage, media playback)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Some payment methods (e.g., Google Pay on Android) require Custom Chrome Tabs rather than a standard WebView."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["More integration effort than redirect."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comparison","__idx":3},"children":["Comparison"]},{"$$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":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Redirect"},"children":["Redirect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"iFrame / WebView"},"children":["iFrame / WebView"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer leaves your app"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integration effort"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Low"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Medium"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Co-branding support"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Camera / KYC support"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Native browser"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requires WebView config"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Apple Pay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Web iFrame: No (redirects to new Banxa tab); iOS WebView: Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Google Pay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Android: Custom Chrome Tabs required; iOS: Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"recommendation","__idx":4},"children":["Recommendation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect"]}," if you want the fastest integration or are building a mobile app where WebView complexity is a concern."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["iFrame / WebView"]}," if keeping the customer inside your product is a priority and you have the capacity to handle platform-specific WebView configuration."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both options are compatible with both Referral and API integration methods."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ For implementation details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/checkout-experience/redirect/redirect-overview"},"children":["Redirect Checkout"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-checkout/docs/checkout-experience/iframe/iframe-overview"},"children":["Embedded Checkout (iFrame)"]},"."]}]},"headings":[{"value":"Checkout Visualisation: iFrame vs. Redirect","id":"checkout-visualisation-iframe-vs-redirect","depth":1},{"value":"Redirect","id":"redirect","depth":2},{"value":"Embedded Checkout (iFrame)","id":"embedded-checkout-iframe","depth":2},{"value":"Comparison","id":"comparison","depth":2},{"value":"Recommendation","id":"recommendation","depth":2}],"frontmatter":{"title":"iFrame vs. Redirect Checkout Explained | Banxa Docs","description":"Compare iFrame embedding and redirect checkout for Banxa. Understand trade-offs for web and mobile, WebView requirements, and payment method support.","seo":{"title":"Checkout Visualisation: iFrame vs. Redirect"}},"lastModified":"2026-05-19T23:30:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/hosted-checkout/docs/getting-started/choose-visualisation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}