{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-cashier/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Open without the SDK","siteUrl":"https://docs.omno.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"open-without-the-sdk","__idx":0},"children":["Open without the SDK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can open the Cashier without the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/quick-start"},"children":["Web SDK"]}," by redirecting to, or embedding, the URLs returned when you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/integrate"},"children":["create a session"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depositUrl"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["withdrawalUrl"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ℹ️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/quick-start"},"children":["Web SDK"]}," unless a technical constraint prevents it. It's the recommended way to open the Cashier — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#what-you-lose-without-the-sdk"},"children":["what you lose"]}," below."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pass-the-cashier-token","__idx":1},"children":["Pass the Cashier token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Opening is only authorized with the Cashier ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}," from the create-session response. Append it to the returned URL as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["omCashierToken"]}]}," query parameter, URL-encoded. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ct"]}," is an accepted alias"]}," for the same parameter."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"<checkoutUrl>?omCashierToken=<url-encoded-token>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Cashier reads the token on load, stores it server-side, and strips it from the address bar — so it doesn't linger in browser history or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Referer"]}," headers. Treat the token as a credential and never log it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"redirect","__idx":2},"children":["Redirect"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// checkoutUrl / depositUrl / withdrawalUrl come from POST /v3/public/cashier/session\nwindow.location.href = `${checkoutUrl}?omCashierToken=${encodeURIComponent(token)}`;\n// `ct` works as an alias: `${checkoutUrl}?ct=${encodeURIComponent(token)}`\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"embed-in-an-iframe","__idx":3},"children":["Embed in an iframe"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"html","header":{"controls":{"copy":{}}},"source":"<iframe\n  src=\"<checkoutUrl>?omCashierToken=<url-encoded-token>\"\n  width=\"900\"\n  height=\"800\">\n</iframe>\n","lang":"html"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutUrl"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depositUrl"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["withdrawalUrl"]}," exactly as returned by the create-session response, with the token appended."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-lose-without-the-sdk","__idx":4},"children":["What you lose without the SDK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Opening the raw URL works but drops the SDK's payment, KYC and analytics events, close/overlay handling, dynamic language, device detection and mobile sheet, styling, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentAction"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["containerId"]},", and the utility methods. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/methods"},"children":["Web SDK → Methods"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/events"},"children":["Events"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"final-status","__idx":5},"children":["Final status"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warning:"]}," The hosted Cashier's redirect or on-screen result is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," authoritative. Determine the final status from a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/concepts/webhooks"},"children":["webhook"]}," or a GET on the transaction."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"build-it-","__idx":6},"children":["Build it →"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/session-and-token"},"children":["Session & token"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/cashier/sdk/quick-start"},"children":["Web SDK → Quick start"]}]}]}]},"headings":[{"value":"Open without the SDK","id":"open-without-the-sdk","depth":1},{"value":"Pass the Cashier token","id":"pass-the-cashier-token","depth":2},{"value":"Redirect","id":"redirect","depth":2},{"value":"Embed in an iframe","id":"embed-in-an-iframe","depth":2},{"value":"What you lose without the SDK","id":"what-you-lose-without-the-sdk","depth":2},{"value":"Final status","id":"final-status","depth":2},{"value":"Build it →","id":"build-it-","depth":2}],"frontmatter":{"title":"Open without the SDK","description":"Open the Omno Cashier by redirecting to or embedding the hosted URLs, passing the mandatory Cashier token as the omCashierToken query parameter (ct is an alias).","seo":{"title":"Open without the SDK"}},"lastModified":"2026-11-06T11:46:00.425Z","pagePropGetterError":{"message":"","name":""}},"slug":"/cashier/hosted-url","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}