Countersign

Guide

Stripe restricted key for refunds only: exact permissions and setup

The three permissions a refund gate needs (Charges: Read, Customers: Read, Refunds: Write) and how to create the key.

The three permissions

Charges: Read, to read the real amount, refunded balance, age and dispute flag.

Customers: Read, to see who the customer is and their earlier refunds.

Refunds: Write, to make the refund after approval. Everything else stays None.

Create the key

In Stripe, open Developers → API keys → Create restricted key. Name it "Countersign", set the three permissions above, leave the rest at None, and create it.

Start in test mode: the same steps with "Viewing test data" on give you an rk_test_ key.

Check it

Paste it into Countersign: it checks each permission without moving money and tells you exactly which one is missing.

Try it without writing code

The live demo shows a support agent asking for refunds, the policy deciding, and an approve card on your phone.

More: How to cap the refunds your AI support agent can issue · How to require manager approval for Stripe refunds