Use Browser Pay with Kernel - Sapiom Pay

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

Create a browser

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

const response = await fetch("https://api.onkernel.com/browsers", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KERNEL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ timeout_seconds: 300 }),
});
if (!response.ok) throw new Error(`Kernel HTTP ${response.status}`);
const browser = await response.json();
const sessionId: string = browser.session_id;
const cdpUrl: string = browser.cdp_ws_url;

timeout_seconds is idle time. Kernel deletes the browser after 300 seconds with no CDP or live view connection. Pass cdpUrl to attachInterceptor, and connect your driver to the same URL.

Delete the browser

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

await fetch(`https://api.onkernel.com/browsers/${sessionId}`, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.KERNEL_API_KEY}` },
});

If you only close your driver, the browser runs until the idle timeout.