Countersign

Integrations · Agent framework

How to let OpenAI Agents SDK issue Stripe refunds with manager approval

A function tool for OpenAI agents that refunds only within policy. A @function_tool posts to Countersign.

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: OpenAI Agents 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 environment.
  3. Give the tool to your agent instead of any Stripe refund tool. The agent never sees a Stripe key.
python
import os, requests
from agents import function_tool

@function_tool
def request_refund(charge_id: str, amount_cents: int, reason: str, reasoning: str, ticket_url: str = "") -> dict:
    """Ask for a Stripe refund. Small ones that fit policy go through at once; others wait for a person.
    Relay the returned 'message' to the customer and never promise a refund that is pending or denied."""
    r = requests.post(
        "https://countersign.vibiz.app/api/v1/refunds/request",
        headers={"Authorization": f"Bearer {os.environ['COUNTERSIGN_KEY']}"},
        json={"charge_id": charge_id, "amount": amount_cents, "reason": reason,
              "agent_reasoning": reasoning, "ticket_url": ticket_url or None, "agent_name": "openai-agents"},
        timeout=30,
    )
    return r.json()

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

Get my OpenAI Agents SDK snippetTry the live demo

Questions

Does OpenAI Agents SDK get access to my Stripe account?

No. OpenAI Agents 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 ScoutFrontCrispn8nMakeZapierLangGraphClaude & MCPVercel AI SDKMastraCrewAI