[kishannatural]

Summary

Adds an integration guide, Natural (/integrations/natural), for developers whose Kernel browser agent needs to pay at checkout. Natural lets the agent pay with a card the user saved on Natural, and the real card number never reaches the agent, the developer's servers, or Kernel. Nothing new is needed on the Kernel side: the integration uses a Kernel custom proxy with a CA bundle, which Natural's proxy uses to swap the stand-in card for the real one on its way to the processor.

• integrations/natural.mdx: when to use Natural, how the flow works, who sees what, the Kernel-side proxy create and swap code (TypeScript and Python), how to find the processor host, and links to Natural's full Kernel guide
• docs.json: page added under How it works → Configure → Payments
• integrations/overview.mdx: Natural card under "Credentials, identity, and payments"
• browsers/payments.mdx: link under "Get started"

Worth checking

• proxies/custom.mdx says a proxy with a ca_bundle "can't [be hot-swapped] onto a running browser". Natural's flow (and this page) creates the proxy with ca_bundle and swaps it onto the running browser with browsers.update(..., { proxy: { id } }), then resets with { proxy: { mode: "default" } }. If hot-swapping CA-bundle proxies is supported now, the custom proxies page may need updating. If it isn't, we'll adjust this guide.
• The page follows the existing style (title case for the H1, sentence case below it) and the TS+Python code example rule in AGENTS.md.

Previewed locally with mint dev.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only; reviewers should confirm the hot-swap flow for ca_bundle proxies matches proxies/custom.mdx, which currently says CA-bundle proxies cannot be hot-swapped onto a running browser.

Overview
Adds /integrations/natural, a new guide for paying at merchant checkout with a user’s Natural saved card via Kernel custom proxies (stand-in card in the browser, real card swapped at the payment processor).

The page covers when to use Natural (including non-checkout wallet flows), the approval → claim → proxy swap → pay → cleanup sequence, TypeScript/Python examples for creating a proxy from a claim and attaching it with browsers.update, processor-host discovery, and operational warnings (proxy errors, claim secrecy, single submit).

Navigation: registers the page under How it works → Configure → Payments in docs.json, adds a Natural card on the integrations overview, and links it from Payments → Get started.

^{Reviewed by Cursor Bugbot for commit 1d87d67. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 1d87d67.

Approve preview

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Natural partner missing SVG icon

Medium Severity

The new Natural partner card and standalone page use the Mintlify font icon wallet instead of an SVG under images/integration-icons/. Font icons often fail to render on integration cards and nav, so the new partner is likely to show a missing or broken icon.

Additional Locations (1)

• integrations/natural.mdx#L3-L4

 

^{Triggered by learned rule: Integration sidebar icons need CDN-safe CSS selectors}

^{Reviewed by Cursor Bugbot for commit 2e99b77. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1d87d67. Configure here.}

[cursor]

Partner page missing SVG icon

Medium Severity

Natural is a new partner page and overview card, but both use the Mintlify font icon wallet and there is no SVG under images/integration-icons/. New partner cards and standalone pages need a logo file; font icons often fail to render on Integrations.

Additional Locations (1)

• integrations/overview.mdx#L123-L126

 

^{Triggered by learned rule: Integration sidebar icons need CDN-safe CSS selectors}

^{Reviewed by Cursor Bugbot for commit 1d87d67. Configure here.}