Integration · Recharge

Let your AI agent manage Recharge subscriptions — safely.

Test refunds, cancellations, product swaps and discount codes against a simulated Recharge account that fails on purpose. In production, COLVO holds the API token, applies your limits and checks every result in Recharge.

How it works

Set it up in minutes

  1. Test without a store. In “Choose scenarios…”, pick Recharge: 10 scenarios run against a simulated Recharge account — numeric ids, a charge is what gets refunded, a product swap is a plan change.
  2. Create an API token for COLVO in Recharge → Apps & integrations → API tokens: read/write on Subscriptions, Payments and Discounts, read on Orders and Customers. COLVO checks the scopes without changing anything.
  3. No webhook to copy. COLVO registers its own webhooks in Recharge; refunds and cancellations made outside COLVO open an incident.
  4. Your agent proposes, COLVO executes. The agent never holds the token. Guard decides ALLOW, REVIEW, HOLD or DENY, writes once, and re-reads Recharge to verify.

Actions on Recharge today

refund.create              payment_id = the charge, amount_minor, currency   → a refund on the charge
subscription.cancel        subscription_id, mode: immediate                   → cancels now: no further charges
subscription.change_plan   subscription_id, price_id = product variant, at: now → swap from the next charge
coupon.apply               subscription_id, coupon_id = discount code         → on the subscription’s address

Not on Recharge: cancel at period end, pause / resume, undo a cancellation

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

What you get

Recharge + COLVO

Never a second refund

Recharge takes no idempotency keys and refunds carry no note. If an answer is lost, COLVO never re-sends — it opens an incident and a person checks the charge.

Cancels do what they say

Recharge cancels now: the next charge and box don’t happen. A proposal to cancel “at the end of the period” is refused before anything is sent.

Same rules as Stripe

Limits, approvals, allowed products and allowed discount codes work the same; only the ids are Recharge’s.

Questions

Recharge FAQ

Does the agent need my Recharge token?

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

Which scopes?

read/write on Subscriptions, Payments and Discounts; read on Orders and Customers. COLVO warns about any other scope.

How are refunds verified?

Recharge reports refunds as a total per charge, so COLVO checks the charge’s refunded total — exact for the usual one refund per charge.

Shopify orders too?

Yes — connect the store itself as a separate Shopify connection for order refunds and cancellations.

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.

Recharge AI agent testing and guardrails — COLVO · COLVO