Set up Stripe

1

Open the API keys

In the Stripe Dashboard, open Developers at the bottom of the sidebar, then API keys. Or go straight to dashboard.stripe.com/apikeys.

Check the account picker at the top left before you copy anything: keys belong to the account and the mode you’re in.

2

Copy the secret key

Under Standard keys, reveal the Secret key and copy it. The Publishable key is meant for a browser and can’t read anything an agent needs.

export STRIPE_API_KEY=sk_test_...

Start with sk_test_…, from a sandbox or test mode, which moves no money. The pack reads the variable on its next call, and the key doesn’t expire.

3

Prefer a restricted key

A secret key can do anything the account can, refunds included. For an agent, click Create restricted key on the same page and grant only what its tools touch, for example Read on customers, charges and invoices for an agent that answers questions. The key begins rk_ and goes in the same variable:

export STRIPE_API_KEY=rk_test_...

A tool that needs a permission you left off answers with a 403 that names the permission.

4

Verify

verify_stripe.py

import asyncio

from charter.packs import stripe


async def main():
    print(await stripe.customers_list.ainvoke(limit=3))


asyncio.run(main())

Up to three customers, newest first. An empty list on a new test account is still a pass: it proves the key was accepted.

​

Your users’ accounts

​

Related

• Stripe — the pack, form encoding, idempotency and Connect
• Register a Stripe App — the app your users install, and how to test it
• Every pack — what the other packs need, in one table