Stripe - nself-org/plugins GitHub Wiki

Stripe Commands

Entry Points

  • Shell actions: nself plugin stripe <action> [args...]
  • TypeScript CLI: pnpm exec nself-stripe <command> [args...] (run from plugins/stripe/ts)

Shell Action Matrix

Action Syntax Subcommands Notes
sync nself plugin stripe sync [target] all, customers, products, prices, subscriptions default target: all
customers nself plugin stripe customers <command> [args] list [limit] [offset], get <id>, search <query>, count count also accepts stats alias
subscriptions nself plugin stripe subscriptions <command> [args] list [status] [limit], get <id>, stats, mrr status examples: active, trialing, past_due, canceled, all
invoices nself plugin stripe invoices <command> [args] list [status] [limit], get <id>, stats, recent [limit], failed [limit] status examples: draft, open, paid, uncollectible, void, all
webhook nself plugin stripe webhook <command> [args] status, events [limit] [type], get <event_id>, errors [limit], retry <event_id>, retry-all [limit] webhook inspection/retry controls

TS CLI Matrix (nself-stripe)

Command Syntax Options
sync pnpm exec nself-stripe sync -r, --resources <resources>, -i, --incremental
server pnpm exec nself-stripe server -p, --port <port>, -h, --host <host>
init pnpm exec nself-stripe init none
status pnpm exec nself-stripe status none
customers pnpm exec nself-stripe customers [action] [id] -l, --limit <limit>
subscriptions pnpm exec nself-stripe subscriptions [action] [id] -l, --limit <limit>, -s, --status <status>
invoices pnpm exec nself-stripe invoices [action] [id] -l, --limit <limit>, -s, --status <status>
products pnpm exec nself-stripe products [action] [id] -l, --limit <limit>
prices pnpm exec nself-stripe prices [action] [id] -l, --limit <limit>

Multi-Account Unified Sync

Both shell and TS sync commands can aggregate multiple Stripe accounts into one sync run when these env vars are set:

  1. STRIPE_API_KEYS (comma-separated API keys)
  2. STRIPE_ACCOUNT_LABELS (optional comma-separated labels in the same order)
  3. STRIPE_WEBHOOK_SECRETS (optional comma-separated webhook secrets in the same order)

If not provided, the plugin falls back to single-account mode with STRIPE_API_KEY. Synced rows are tagged with source_account_id; CLI list output also prefixes records with [account-id].

Action values in TS CLI:

  1. customers: list, show, sync
  2. subscriptions: list, show, stats
  3. invoices: list, show
  4. products: list, show
  5. prices: list, show

Common Usage

nself plugin stripe sync subscriptions
nself plugin stripe customers search [email protected]
nself plugin stripe invoices list paid 50
nself plugin stripe webhook events 100 customer
pnpm exec nself-stripe subscriptions stats

Source Files

  • plugins/stripe/actions/*.sh
  • plugins/stripe/ts/src/cli.ts

nself | nself-plugins | Commands | Issues | Changelog | License

⚠️ **GitHub.com Fallback** ⚠️