Capabilities

Payments

Money runs through your Stripe account. Agents call capabilities. They never see the secret key.

Connect Stripe on Integrations. Until then, payment tools tell the agent to send you there. Amounts are in the smallest currency unit (cents for USD).

Tools

  • payments.create_checkout — amount, currency, name, successUrl, cancelUrl, customerEmail
  • payments.get_customer — required id
  • payments.list — optional limit
  • payments.refund — paymentIntent, optional amount
{
  "amount": 4900,
  "currency": "usd",
  "name": "Visit",
  "successUrl": "https://app.example.com/thanks",
  "cancelUrl": "https://app.example.com/checkout",
  "customerEmail": "[email protected]"
}

REST: POST /v1/<projectId>/payments/:action and GET /v1/<projectId>/payments for the ledger. Logs also appear on the Payments page. See Tokens & security.