Use Browser Pay with Browser Use

Browser Pay connects to the Browser Use browser your worker drives through a CDP WebSocket URL. Browser Use returns cdpUrl, which can be an HTTPS address, so resolve it first. If you already have a browser, start at Resolve the WebSocket URL.

Create a browser

Create a browser session with your Browser Use API key. This starts a browser in your Browser Use account. It does not create a Sapiom transaction.

const response = await fetch("https://api.browser-use.com/api/v2/browsers", {
  method: "POST",
  headers: {
    "X-Browser-Use-API-Key": process.env.BROWSER_USE_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ timeout: 5 }),
});
if (!response.ok) throw new Error(`Browser Use HTTP ${response.status}`);
const session = await response.json();
const sessionId: string = session.id;

timeout is in minutes. Make it long enough for the whole checkout.

Resolve the WebSocket URL

An HTTPS cdpUrl serves the WebSocket URL at /json/version. Browser Pay does not do this lookup for you:

async function toWebSocketUrl(cdpUrl: string): Promise<string> {
  const url = new URL(cdpUrl);
  if (url.protocol === "wss:") return cdpUrl;
  url.pathname = url.pathname.replace(/\/?$/, "/json/version");
  const res = await fetch(url);
  if (!res.ok) throw new Error(`CDP discovery HTTP ${res.status}`);
  const { webSocketDebuggerUrl } = await res.json();
  return webSocketDebuggerUrl;
}

const cdpUrl = await toWebSocketUrl(session.cdpUrl);

Pass cdpUrl to attachInterceptor, and connect your driver to the same URL. Do not pass liveUrl; it is for watching the browser.

Stop the browser

After checkout settles, call handle.detach(), close your driver, and stop the browser:

await fetch(`https://api.browser-use.com/api/v2/browsers/${sessionId}`, {
  method: "PATCH",
  headers: {
    "X-Browser-Use-API-Key": process.env.BROWSER_USE_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ action: "stop" }),
});

Get started

Buyers

Cards

Transactions

Governance

Security

Early access

Use Browser Pay with Browser Use

Create a browser

Resolve the WebSocket URL

Stop the browser

​Create a browser

​Resolve the WebSocket URL

​Stop the browser

Create a browser

Resolve the WebSocket URL

Stop the browser