Skip to main content

​
Checkouts

Create checkout sessions via CLI. Each checkout generates a checkoutUrl (humans) and x402Url (AI agents).

​
Create

agenta pay checkout -a 50
agenta pay checkout -a 99.99 -c EUR -d "Annual subscription"
agenta pay checkout -a 25 --email buyer@example.com

​
Flags

FlagDescription
-a, --amount <n>Payment amount (required)
-c, --currency <code>Currency (EUR, USD). Defaults to org setting
-d, --description <text>Shown on checkout page
--email <email>Pre-populate buyer email

​
Response

{
  "sessionId": "abc123",
  "status": "open",
  "amount": 50,
  "currency": "EURC",
  "checkoutUrl": "https://app.agentaos.ai/checkout/abc123",
  "x402Url": "https://app.agentaos.ai/gateway/v1/x402/abc123",
  "expiresAt": "2026-03-26T12:00:00Z"
}
  • checkoutUrl: Share with human customers
  • x402Url: Use for AI agent-to-agent payments

​
Get

agenta pay get <sessionId>
Poll this to check if payment completed (status === "completed").

​
List

agenta pay list
agenta pay list --status completed --limit 5
FlagDescription
--status <s>Filter: open, completed, expired, cancelled
--limit <n>Results per page (default 10)

​
What’s next?

  • Get notified on payment: Set up webhooks to receive real-time payment confirmations.
  • Machine to machine: Share the x402Url with AI agents instead of the checkout URL. See x402 payments.
  • SDK integration: Build checkout into your backend with the Payment SDK.