---
name: "Stripe"
description: Inspect Stripe customers, payments, subscriptions, invoices, and events through the official `stripe` CLI.
version: 1
situations: stripe, payments, subscriptions, invoices, billing, revenue
requires-secrets:
requires-packages:
requires-connector: stripe
---

# Stripe (`stripe`)

Runs through Stripe's official CLI in your **bash** tool. The operator connected the account from 00's
skill store.

**Read this first: the connected session defaults to TEST mode.** Test mode has its own customers,
its own payments, and its own numbers. Before you report any figure, say which mode it came from — a
revenue total from test mode is not a revenue total.

```
stripe config --list        # which account, which mode
```

Not configured? **Skill store → Stripe → Connect**.

## Read

```
stripe customers list --limit 20
stripe customers retrieve cus_123
stripe subscriptions list --status active --limit 20
stripe invoices list --status open --limit 20
stripe charges list --created "gt=$(date -v-7d +%s)" --limit 50
stripe events list --limit 20
stripe balance retrieve
```

Everything prints JSON. For fields the subcommands don't expose, `stripe get /v1/charges` and
`stripe post` reach the raw API.

## Debugging a payment

1. `stripe events list --limit 20` — what actually happened, in order.
2. `stripe events retrieve evt_…` — the full object, including the failure code.
3. Report Stripe's own `decline_code` / `failure_message`. Paraphrasing a decline reason into
   "the card didn't work" throws away the one detail that tells the operator what to do.

## Webhooks, locally

```
stripe listen --forward-to localhost:3000/webhook
stripe trigger payment_intent.succeeded
```

`stripe listen` runs until stopped — start it only when asked, and stop it when you're done.

## Never, in live mode, without being asked in this turn

Refunds (`stripe refunds create`), cancelling subscriptions, deleting customers, issuing credit
notes, or creating charges. Money moving is the operator's decision, always. In live mode, prefer
reading and reporting; propose the exact command instead of running it.