Skip to main content
Add USDC payments to your app with a hosted checkout page and React component. Locus handles wallet connections, payment confirmation, and webhooks, so you can focus on what you’re selling. The same checkout works for people and AI agents. A person connects a wallet; an agent reads the checkout details and pays programmatically.

​
Add checkout to your app

  1. Create a session on your server with the amount, description, and optional receipt.
  2. Show checkout inline, open a popup, or redirect to the hosted page.
  3. Confirm payment through a signed webhook and fulfill the order.
Start with the integration example. The React SDK is @withlocus/checkout-react.

​
Payment methods

Locus checkout with wallet and agent payment options

Choose a payment method

​
Receipts and payment confirmation

Attach line items, tax, seller details, and support information to a session. The checkout page displays the receipt, and the buyer can find it later in Purchases. When a payment is confirmed on-chain, Locus sends your server a webhook. The React component also calls onSuccess so your UI can show confirmation. Verify the webhook signature before fulfilling an order.

​
Merchant dashboard

Track revenue, session conversion, and payment methods in the dashboard. Group sessions by checkout instance to compare different integration points.
Revenue, sessions, conversion rate, and payment methods

Checkout analytics

​
Sessions

Locus creates the session ID and checkout URL for you. Sessions expire after 30 minutes by default. Only pending sessions can be modified.

​
Next steps

Integration example

Create a session and show checkout.

Merchant integration

Configure the SDK and payment webhooks.

Buyer and agent guide

Pay with a wallet or your agent.