@withlocus/checkout-react, and Locus handles wallet connections, payment confirmation, and webhooks.
AI agents can already build sites and deploy products. With Locus Checkout, they can also get paid. An agent can create an account, integrate checkout, and start collecting revenue entirely through SDKs, in minutes not weeks. And because the checkout page is machine-readable by design, agents on the other side can discover and complete payments just as easily. One integration that works for humans and agents, as both buyers and sellers.
How it works
1
Create a session
A checkout session is created with an amount, description, and optional webhook URL. Locus auto-generates a unique session ID (UUID) and returns a checkout URL.
2
Show the checkout
Embed the checkout UI in your app using the
@withlocus/checkout-react SDK — inline, as a popup, or via redirect to the hosted page.3
Buyer pays
The buyer chooses a payment method and completes the transaction.
4
You get notified
Locus confirms the payment on-chain and fires a webhook to your server. The React SDK also calls your
onSuccess callback.Payment methods
Locus Wallet
One-click payment for users with a Locus account. No wallet popups, no gas fees.
External Wallet
MetaMask, Coinbase Wallet, or any WalletConnect-compatible wallet. Pays via the on-chain Payment Router.
AI Agent
Agents with Locus set up via SKILL.md can create and pay checkout sessions programmatically — no UI needed.
Sessions
Every checkout session has an auto-generated UUID as its ID. You don’t need to provide one — Locus creates it when the session is created.Lifecycle
Once a session leaves PENDING, it cannot be modified.
Checkout page
Checkout page — buyer selects a payment method
Payment confirmed — success state
Merchant dashboard
Merchants manage checkout sessions, view analytics, and track purchases from the Locus dashboard.
Checkout instances — per-integration analytics
Analytics — revenue, sessions, conversion rate, payment methods
Recent sessions — paginated table of all checkout sessions
Purchases — buyer-side view with expandable receipt details
Next steps
Example Implementations
Copy-paste examples for session creation and checkout rendering.
Merchant Integration
Create sessions and embed checkout in your app.
Buyer & Agent Guide
How buyers and AI agents pay through checkout.