{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/legacy-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Steps","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":"p","attributes":{},"children":["By implementing a widget, you will be able to embed the Banxa site in an iFrame and allow customers to complete the checkout process within this iFrame. This can be done using a code snippet that Banxa will provide to you in the Create Order response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note. the iFrame cannot be used in Safari as Safari does not allow third party cookies that the iFrame requires."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these instructions if you are implementing the Banxa API. If you are implementing the Referral Method, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/legacy-api/docs/on-ramp-off-ramp/referral-method"},"children":["Referral Method"]}," section."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"steps","__idx":0},"children":["Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call the Create Order API, and include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe_domain"]}," parameter in the body of the request. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iframe_domain"]}," should be the exact domain that you will be using to host the iFrame e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["binance.beta.io"]},", and NOT your Banxa domain that was provided to you e.g. binance.banxa.com. Our CSP headers will then allow this frame-ancestor to be using Banxa checkout in an iFrame element."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not include https:// in front of the domain."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout_iframe"]}," value that is returned in the Create Order response will be the checkout URL that can be used within the iFrame element on your site."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The iframe should be loaded within a modal div and below is the recommended iframe format:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<iframe src=\"{checkout_iframe}\" style=\"border:0; width: 100%; min-height: 80vh;\"></iframe>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When moving from different environments. you will need to have your session/cache cleared otherwise whitelisted domains will not have carried over."]}]}]},"headings":[{"value":"Steps","id":"steps","depth":2}],"frontmatter":{"title":"Widget (iFrame)","seo":{"title":"Steps"}},"lastModified":"2026-05-19T23:30:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/legacy-api/docs/on-ramp-off-ramp/on-ramp-api-tutorial/widget-iframe","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}