Integrate mobile WebViews

Use mobile WebViews when your native app needs to open the hosted 0Gate flow without building a native checkout surface. The mobile app starts from your backend, opens a hosted checkout page, listens for your return or cancel URL, and reads final status from your server.

Mobile flow

Recommended architecture

Start from a web handoff page

The safest mobile pattern is to open a page you control, then let that page call the browser SDK redirect. This keeps hosted URL generation and browser behavior consistent with your web integration.

import { GateRamp } from '@0bit/gate/browser';

export function startMobileCheckout(clientSecret: string) {
  GateRamp.redirectToCheckout({
    publishableKey: import.meta.env.VITE_GATE_PUBLISHABLE_KEY,
    clientSecret,
    environment: 'sandbox',
    theme: 'light',
  });
}

Your mobile app opens that handoff page in a WebView or system browser after your backend has created the attempt and session.

Intercept only your own URLs

When navigation reaches your return_url or cancel_url, close or replace the WebView and show a status page backed by your API.

func webView(_ webView: WKWebView,
             decidePolicyFor navigationAction: WKNavigationAction,
             decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
  guard let url = navigationAction.request.url else {
    decisionHandler(.allow)
    return
  }

  if url.host == "app.example.com", url.path.starts(with: "/checkout/") {
    showCheckoutStatus(url)
    decisionHandler(.cancel)
    return
  }

  decisionHandler(.allow)
}

override fun shouldOverrideUrlLoading(view: WebView, request: WebResourceRequest): Boolean {
  val uri = request.url
  if (uri.host == "app.example.com" && uri.path?.startsWith("/checkout/") == true) {
    showCheckoutStatus(uri)
    return true
  }
  return false
}

WebView checklist

Customer states

Do not

• Put sk_* credentials, webhook secrets, or provider credentials in the app.
• Scrape hosted iframe DOM or inject code into the 0Gate flow.
• Fulfill, credit, ship, or release value from a WebView navigation event.
• Surface raw provider, compliance, treasury, or internal diagnostic details to customers.

Related pages