Integration · Stripe

Let your AI agent touch Stripe — safely.

Test refunds and cancellations against a simulated Stripe that fails on purpose. In production, COLVO holds a restricted key, applies your limits and checks every result in Stripe.

How it works

Set it up in minutes

  1. Test without a Stripe account. Every test attempt gets its own simulated Stripe world with real-looking customers, payments and subscriptions — and injected faults like timeouts and lost responses.
  2. Connect a restricted key for production. From the project page: COLVO probes the permissions read-only before saving, and live keys must be restricted (rk_live_).
  3. Your agent proposes, COLVO executes. The agent never holds the key. Guard decides ALLOW, REVIEW, HOLD or DENY, executes once and re-reads Stripe to verify.

Actions available today

refund.create              payment_id, amount_minor, currency, reason?
subscription.cancel        subscription_id, mode: period_end | immediate
subscription.pause         subscription_id, resumes_at?, behavior: void | keep_as_draft
subscription.resume        subscription_id
subscription.cancel_undo   subscription_id
subscription.change_plan   subscription_id, price_id, at: now | period_end
coupon.apply               subscription_id, coupon_id
refund.create (older)      invoice_id or charge_id instead of payment_id

The agent never holds your payment keys — it proposes, COLVO decides and executes.

What you get

Stripe + COLVO

Verdict from Stripe, not the reply

Every test ends with expected vs observed state. A wrong amount or an early cancellation is a FAIL even if the reply sounds right.

A retry never doubles a refund

Idempotency key plus a business key per mandate and target: the same refund can only happen once.

Out-of-band changes noticed

Stripe webhooks are matched to operations; a refund nobody proposed raises an alert.

Questions

Stripe FAQ

Does the agent need my Stripe key?

No — remove it. Only COLVO’s executor uses the restricted key, encrypted per organisation.

Which Stripe permissions?

Refunds and subscriptions write, plus read access for verification. The connect screen lists them and checks each one.

Test mode or live mode?

Both. Test-mode keys connect directly; live keys must be restricted.

Reference: Mandates & connections · Webhooks

≠

Stop trusting the reply.

Test your agent before it ships — and guard every real action once it’s live. In a safe copy of your world first.

Stripe AI agent testing and guardrails — COLVO · COLVO