Use Browser Pay with Browserbase - Sapiom Pay

Browser Pay connects to the Browserbase session your worker drives through its CDP WebSocket URL, connectUrl. If you already have a session, use its connectUrl and go to Attach Browser Pay.

Create a session

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

const response = await fetch("https://api.browserbase.com/v1/sessions", {
  method: "POST",
  headers: {
    "X-BB-API-Key": process.env.BROWSERBASE_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ timeout: 300 }),
});
if (!response.ok) throw new Error(`Browserbase HTTP ${response.status}`);
const session = await response.json();
const sessionId: string = session.id;
const cdpUrl: string = session.connectUrl;

timeout is the session’s maximum length in seconds. Make it long enough for the whole checkout. Pass cdpUrl to attachInterceptor, and connect your driver to the same URL.

Release the session

After checkout settles, call handle.detach(), close your driver, and request release:

await fetch(`https://api.browserbase.com/v1/sessions/${sessionId}`, {
  method: "POST",
  headers: {
    "X-BB-API-Key": process.env.BROWSERBASE_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ status: "REQUEST_RELEASE" }),
});

The session ends when its status is COMPLETED.