stripe

# Stripe

Interact with your Stripe account directly via the Stripe API (`api.stripe.com`).

## Setup (one-time)

1. Get your secret key from https://dashboard.stripe.com/apikeys
2. Set environment variable:
   ```
   STRIPE_SECRET_KEY=sk_live_...
   ```
   Use `sk_test_...` for test mode.

## Queries

### List recent charges
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py charges --limit 10
```

### List customers
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py customers --limit 20
```

### Search customers by email
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py customers --email user@example.com
```

### List subscriptions
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py subscriptions --limit 20
```

### List active subscriptions
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py subscriptions --status active --limit 20
```

### List invoices
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py invoices --limit 20
```

### List payment intents
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py payment_intents --limit 20
```

### List products
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py products --limit 20
```

### List prices
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py prices --limit 20
```

### List refunds
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py refunds --limit 20
```

### Get a specific object
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py get charges ch_abc123
python3 /mnt/skills/user/stripe/scripts/stripe_query.py get customers cus_abc123
python3 /mnt/skills/user/stripe/scripts/stripe_query.py get subscriptions sub_abc123
```

### Create a refund
```bash
python3 /mnt/skills/user/stripe/scripts/stripe_query.py create refunds --charge ch_abc123
python3 /mnt/skills/user/stripe/scripts/stripe_query.py create refunds --charge ch_abc123 --amount 1000
```

### Update a customer
```bash
p...

# stripe

A OpenClaw skill for querying and managing your Stripe account — directly via `api.stripe.com`, no third-party proxy.

## What it does

Ask OpenClaw things like:

> "Show me the last 10 charges"  
> "Find the customer with email john@acme.com"  
> "List all active subscriptions"  
> "Refund charge ch_abc123"  
> "Update customer cus_abc123's email"

## Setup

**1. Get your Stripe secret key**

Go to [dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys) and copy your secret key.

- `sk_test_...` for test mode
- `sk_live_...` for production

**2. Set the environment variable**

```bash
export STRIPE_SECRET_KEY=sk_live_...
```

## Supported resources

| Resource | List | Get | Create | Update |
|---|---|---|---|---|
| charges | ✅ | ✅ | | |
| customers | ✅ | ✅ | | ✅ |
| invoices | ✅ | ✅ | | |
| subscriptions | ✅ | ✅ | | |
| payment_intents | ✅ | ✅ | | |
| refunds | ✅ | ✅ | ✅ | |
| products | ✅ | ✅ | | |
| prices | ✅ | ✅ | | |
| balance_transactions | ✅ | ✅ | | |

## Usage

### List resources

```bash
python3 scripts/stripe_query.py charges --limit 10
python3 scripts/stripe_query.py customers --limit 20
python3 scripts/stripe_query.py subscriptions --status active
python3 scripts/stripe_query.py invoices
python3 scripts/stripe_query.py payment_intents
python3 scripts/stripe_query.py products
python3 scripts/stripe_query.py prices
python3 scripts/stripe_query.py refunds
python3 scripts/stripe_query.py balance_transactions
```

**Filters**

```bash
--limit N          # number of results (default: 20)
--email EMAIL      # filter customers by email
--status STATUS    # filter by status (e.g. active, canceled, paid)
--customer ID      # filter by customer ID
--json             # output raw JSON instead of table
```

### Get a specific object

```bash
python3 scripts/stripe_query.py get charges ch_abc123
python3 scripts/stripe_query.py get customers cus_abc123
python3 scripts/stripe_query.py get subscriptions sub_abc123
```

### Cre...