[bmsaadat]

Adds a Shop Pay wallet page and links it from the payments docs.

Changes

• New integrations/wallets/shop-pay.mdx: connect through KERNEL's Shop app, choose a saved card, create and authorize a card at checkout, fill, report the outcome with confirm_transaction, and the item reference. Live only, USD only.
• Wallet overview: Shop Pay row, the shop_pay_oauth action, and that Shop Pay has no provider configuration.
• Payments overview: Shop Pay in the how-it-works steps, including reporting the outcome with confirm_transaction. Nav entry after Link.
• Browser agent walkthrough: points to the Shop Pay page, recommends a headful or 2GiB+ headless browser for checkout, and notes Stripe's "save my information with Link" box, which blocks payment without a phone number.

Before merging

• The CLI tabs need a CLI release that includes CLI: Update Go SDK to 738369d524a3806832577f6793dde7eaf15c5725 cli#304.

Testing

• Ran the TypeScript and Python examples against the prod API with SDK 0.139.0: payment methods, create, update before authorize, authorize at checkout and for merchant_url, re-reading for a fresh approval link, and the 409s for confirming while pending and updating after authorize. Each card was deleted before approval.
• Fill and confirm_transaction ran in two real $1 purchases through the MCP and CLI the same day.
• All TypeScript blocks typecheck together against the SDK; mint validate and mint broken-links pass.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only changes with no runtime or auth code; incorrect guidance could mislead integrators on live USD checkout flows.

Overview
Adds Shop Pay as a documented wallet provider and wires it through the payments doc set.

The new integrations/wallets/shop-pay.mdx page describes the full flow: OAuth via shop_pay_oauth, optional payment_methods selection, checkout-scoped authorize, fill with origin rules and billing fields, and closing the purchase with confirm_transaction (live only, USD only, KERNEL-managed Shop app—no BYO provider config).

Cross-links and nav: docs.json lists the page under Payments (after Link). The wallets overview adds a provider row, shop_pay_oauth in payment actions, and notes that Shop Pay purchases stay card items. The payments overview and browser-agent guide mention Shop Pay in the lifecycle steps and point readers to the dedicated guide.

Smaller guide updates: a Tip recommends headful checkout or headless browsers with at least 2GiB memory so authorization/fill don’t stall on heavy pages. A new accordion covers Stripe’s pre-checked “save with Link” option, which forces a phone number unless unchecked before submit.

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

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Kernel	🟢 Ready	View Preview	Nov 2, 2026, 4:36 PM

💡 Tip: Enable Automations to automatically generate PRs for you.