stripe

README.md

---
name: stripe
description: Create Stripe customers, prices, and payment links; list charges and create refunds using the Stripe API. Use when the user needs payments, checkout links, billing operations, or Stripe transaction lookup.
credentials:
  - STRIPE_SECRET_KEY
metadata:
  sulala:
    emoji: "💳"
    requires:
      bins:
        - node
---

# Stripe

Create and manage core Stripe payment operations with scripts in this skill directory. The agent should use the `exec` tool with `skill_id: "stripe"` so `STRIPE_SECRET_KEY` from skill config is injected automatically.

## When to use

- Create a customer in Stripe
- Create a price for a product
- Create a payment link for checkout
- List recent charges
- Refund a charge (full or partial)

## Prerequisites

1. Add the `stripe` skill to your agent.
2. Configure `STRIPE_SECRET_KEY` in skill settings.

## Setup

1. Sign in to [Stripe Dashboard](https://dashboard.stripe.com/).
2. Go to **Developers → API keys**.
3. Copy your **Secret key** (`sk_test_...` for test mode, `sk_live_...` for live mode).
4. Paste it into the skill config as `STRIPE_SECRET_KEY`.

Use test mode for development unless you intentionally need live charges.

## Scripts

- `scripts/create_customer.js` — create a Stripe customer with email and optional name.
- `scripts/create_price.js` — create a recurring or one-time price for an existing product.
- `scripts/create_payment_link.js` — create a payment link from a price ID and quantity.
- `scripts/list_customers.js` — list recent customers.
- `scripts/list_charges.js` — list recent charges.
- `scripts/create_refund.js` — create a refund for a charge (full by default).

## Create a customer

Example:

- `skill_id`: `stripe`
- `command`: `node ./scripts/create_customer.js "user@example.com" "Jane Doe"`

Arguments:

- `email` (required)
- `name` (optional)

## Create a price

Example (monthly recurring):

- `command`: `node ./scripts/create_price.js prod_123 2900 usd month`

Example (one-time):

- `command`: `node ./scripts/create_price.js prod_123 500 usd`

Arguments:

- `product_id` (required)
- `unit_amount` (required, smallest currency unit; e.g. cents)
- `currency` (optional, default `usd`)
- `interval` (optional; if set to `day|week|month|year`, creates recurring price)

## Create a payment link

Example:

- `command`: `node ./scripts/create_payment_link.js price_123 1`

Arguments:

- `price_id` (required)
- `quantity` (optional, default `1`)

## List charges

Example:

- `command`: `node ./scripts/list_charges.js 10`

Argument:

- `limit` (optional, default `10`, max `100`)

## List customers

Example:

- `command`: `node ./scripts/list_customers.js 10`

Argument:

- `limit` (optional, default `10`, max `100`)

## Create a refund

Example (full refund):

- `command`: `node ./scripts/create_refund.js ch_123`

Example (partial refund of 500 cents):

- `command`: `node ./scripts/create_refund.js ch_123 500`

Arguments:

- `charge_id` (required)
- `amount` (optional; if omitted Stripe performs full refund)

## Notes

- All scripts return raw Stripe API JSON to stdout.
- Common failures:
  - `401`: invalid or missing key
  - `403`: key lacks permission for the operation
  - `400`: invalid argument (wrong ID, amount, or format)