Countersign

Integrations · Agent framework

How to let Vercel AI SDK issue Stripe refunds with manager approval

A typed refund tool for AI SDK agents. A tool() with a zod schema calls the endpoint.

Auto-approve under $50

Small refunds that fit your rules go through at once.

Route the rest

A named approver gets a one-tap card on their phone.

Log everything

Who approved, why, the Stripe refund id. CSV for finance.

Setup: Vercel AI SDK tool

  1. Sign up free, connect Stripe with a restricted key (test mode works) and pick a policy.
  2. Set COUNTERSIGN_KEY in your server environment.
  3. Add the tool to your agent. It returns status and a message to relay.
typescript
import { tool } from 'ai';
import { z } from 'zod';

export const requestRefund = tool({
  description: 'Ask for a Stripe refund. Small ones that fit policy go through; others wait for a person. Relay "message".',
  parameters: z.object({
    charge_id: z.string(), amount_cents: z.number().int(), reason: z.string(), reasoning: z.string(),
    ticket_url: z.string().url().optional(),
  }),
  execute: async (a) => {
    const r = await fetch('https://countersign.vibiz.app/api/v1/refunds/request', {
      method: 'POST',
      headers: { Authorization: `Bearer ${process.env.COUNTERSIGN_KEY}`, 'Content-Type': 'application/json' },
      body: JSON.stringify({ charge_id: a.charge_id, amount: a.amount_cents, reason: a.reason,
        agent_reasoning: a.reasoning, ticket_url: a.ticket_url, agent_name: 'vercel-ai-sdk' }),
    });
    return r.json();
  },
});

Replace cs_YOUR_KEY; in the dashboard this snippet comes with your key filled in.

Get my Vercel AI SDK snippetTry the live demo

Questions

Does Vercel AI SDK get access to my Stripe account?

No. Vercel AI SDK gets a Countersign key that can only ask for refunds. Countersign holds a restricted Stripe key and refunds only after your policy or an approver says yes.

What does the agent get back?

status (approved_and_refunded, pending or denied), a message to relay to the customer, the rule that decided it, and a status_url for pending requests.

Who approves the big ones?

The approver for that amount tier gets an email with a one-tap approve card: customer, charge, refundable balance, earlier refunds, the agent's reasoning and the ticket link.

Other integrations

Intercom FinZendesk AI agentsGorgiasFreshdesk FreddyHelp ScoutFrontCrispn8nMakeZapierLangGraphOpenAI Agents SDKClaude & MCPMastraCrewAI