Agent skill

stripe

Stripe API for payments. Use when user mentions "Stripe", "payment", "subscription", "billing", "invoice", or asks about payment processing.

View SKILL.md on GitHub Repository
Stars 50
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/vm0-ai/vm0-skills/tree/main/stripe

SKILL.md

Stripe API

Manage payments, customers, subscriptions, and billing with the Stripe API.

Official docs: https://docs.stripe.com/api

When to Use

  • Manage customers (create, update, list, delete)
  • Create products and prices for billing
  • Manage subscriptions and invoices
  • Create and track payment intents
  • View account balance and transactions
  • List charges and events

Important: Stripe Uses Form-Encoded Bodies

Stripe API accepts application/x-www-form-urlencoded for POST requests, not JSON. Write request bodies to a .txt file using key=value&key=value format. Nested params use bracket syntax: items[0][price]=price_xxx.

Core APIs

Get Account Info

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/account" | jq '{id, business_profile, charges_enabled, payouts_enabled}'

Docs: https://docs.stripe.com/api/accounts/retrieve

List Customers

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/customers?limit=10" | jq '.data[] | {id, name, email}'

Docs: https://docs.stripe.com/api/customers/list

Get Customer

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/customers/<customer-id>" | jq '{id, name, email, created}'

Create Customer

Write to /tmp/stripe_request.txt:

name=John Doe&email=john@example.com
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/customers" -d @/tmp/stripe_request.txt | jq '{id, name, email}'

Docs: https://docs.stripe.com/api/customers/create

Update Customer

Write to /tmp/stripe_request.txt:

name=Jane Doe
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/customers/<customer-id>" -d @/tmp/stripe_request.txt | jq '{id, name, email}'

Delete Customer

bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X DELETE "https://api.stripe.com/v1/customers/<customer-id>" | jq '{id, deleted}'

Docs: https://docs.stripe.com/api/customers/delete

List Products

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/products?limit=10" | jq '.data[] | {id, name, active}'

Docs: https://docs.stripe.com/api/products/list

Get Product

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/products/<product-id>" | jq '{id, name, description, active}'

Create Product

Write to /tmp/stripe_request.txt:

name=Premium Plan&description=Full access to all features
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/products" -d @/tmp/stripe_request.txt | jq '{id, name, description}'

Docs: https://docs.stripe.com/api/products/create

List Prices

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/prices?limit=10" | jq '.data[] | {id, product, unit_amount, currency, recurring}'

Docs: https://docs.stripe.com/api/prices/list

Create Price

Write to /tmp/stripe_request.txt:

unit_amount=2000&currency=usd&recurring[interval]=month&product=<product-id>
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/prices" -d @/tmp/stripe_request.txt | jq '{id, unit_amount, currency, recurring}'

Docs: https://docs.stripe.com/api/prices/create

List Subscriptions

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/subscriptions?limit=10" | jq '.data[] | {id, customer, status, items: .items.data[0].price.id}'

Docs: https://docs.stripe.com/api/subscriptions/list

Get Subscription

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/subscriptions/<subscription-id>" | jq '{id, customer, status, current_period_start, current_period_end}'

Create Subscription

Write to /tmp/stripe_request.txt:

customer=<customer-id>&items[0][price]=<price-id>
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/subscriptions" -d @/tmp/stripe_request.txt | jq '{id, customer, status}'

Docs: https://docs.stripe.com/api/subscriptions/create

Cancel Subscription

bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X DELETE "https://api.stripe.com/v1/subscriptions/<subscription-id>" | jq '{id, status}'

Docs: https://docs.stripe.com/api/subscriptions/cancel

List Invoices

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/invoices?limit=10" | jq '.data[] | {id, customer, status, amount_due, currency}'

Docs: https://docs.stripe.com/api/invoices/list

Get Invoice

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/invoices/<invoice-id>" | jq '{id, customer, status, amount_due, amount_paid}'

List Payment Intents

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/payment_intents?limit=10" | jq '.data[] | {id, amount, currency, status}'

Docs: https://docs.stripe.com/api/payment_intents/list

Create Payment Intent

Write to /tmp/stripe_request.txt:

amount=2000&currency=usd&payment_method_types[]=card
bash
curl -s -u "$(printenv STRIPE_TOKEN):" -X POST "https://api.stripe.com/v1/payment_intents" -d @/tmp/stripe_request.txt | jq '{id, amount, currency, status}'

Docs: https://docs.stripe.com/api/payment_intents/create

Get Payment Intent

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/payment_intents/<payment-intent-id>" | jq '{id, amount, currency, status}'

List Charges

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/charges?limit=10" | jq '.data[] | {id, amount, currency, status, customer}'

Docs: https://docs.stripe.com/api/charges/list

Get Charge

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/charges/<charge-id>" | jq '{id, amount, currency, status, paid}'

Get Balance

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/balance" | jq '{available, pending}'

Docs: https://docs.stripe.com/api/balance/balance_retrieve

List Balance Transactions

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/balance_transactions?limit=10" | jq '.data[] | {id, amount, currency, type, status}'

Docs: https://docs.stripe.com/api/balance_transactions/list

List Events

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/events?limit=10" | jq '.data[] | {id, type, created}'

Docs: https://docs.stripe.com/api/events/list

Get Event

bash
curl -s -u "$(printenv STRIPE_TOKEN):" "https://api.stripe.com/v1/events/<event-id>" | jq '{id, type, data: .data.object.id}'

Docs: https://docs.stripe.com/api/events/retrieve

Guidelines

  1. Stripe authenticates via HTTP Basic Auth: -u "$(printenv STRIPE_TOKEN):" (colon after key, no password)
  2. POST bodies use form-encoded format (key=value&key=value), not JSON
  3. Nested params use bracket syntax: items[0][price]=price_xxx
  4. Write request bodies to /tmp/stripe_request.txt before sending
  5. Use <placeholder> for dynamic IDs that the user must replace
  6. Empty list responses ({"data": [], "has_more": false}) are normal for test-mode accounts
  7. All monetary amounts are in the smallest currency unit (e.g., cents for USD)

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vm0-ai/vm0-skills

brave-search

Brave Search API for web search. Use when user says "search web", "Brave search", or asks to "find on web" without specifying Google.

50 8
Explore
vm0-ai/vm0-skills

supadata

Supadata API for YouTube/web data. Use when user mentions "Supadata", "YouTube data", "channel stats", or web scraping data.

50 8
Explore
vm0-ai/vm0-skills

roadmap-planning

Build and prioritize product roadmaps using scoring models like RICE, ICE, and value-effort matrices. Activate when creating a product roadmap, prioritizing features, sequencing initiatives, mapping dependencies, balancing team capacity, choosing between Now/Next/Later or quarterly planning, or communicating roadmap tradeoffs to executives and stakeholders.

50 8
Explore
vm0-ai/vm0-skills

qdrant

Qdrant API for vector search. Use when user mentions "Qdrant", "vector database", "semantic search", or embeddings storage.

50 8
Explore
vm0-ai/vm0-skills

calendly

Calendly scheduling API. Use when user mentions "Calendly", "calendly.com", "schedule a meeting", "booking link", "event types", or asks about interview scheduling.

50 8
Explore
vm0-ai/vm0-skills

customer-io

Customer.io behavioral email and messaging platform. Use when user mentions "Customer.io", "behavioral emails", "lifecycle emails", "triggered messages", or asks about event-based email automation.

50 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results