openclaw-backups/archive/inactive-skills/api-gateway/references/stripe.md

Stripe Routing Reference

App name: stripe Base URL proxied: api.stripe.com

API Path Pattern

/stripe/v1/{endpoint}

Common Endpoints

Customers

List Customers

GET /stripe/v1/customers?limit=10

Get Customer

GET /stripe/v1/customers/{customerId}

Create Customer

POST /stripe/v1/customers
Content-Type: application/x-www-form-urlencoded

email=customer@example.com&name=John%20Doe&description=New%20customer

Update Customer

POST /stripe/v1/customers/{customerId}
Content-Type: application/x-www-form-urlencoded

email=newemail@example.com

Products

List Products

GET /stripe/v1/products?limit=10&active=true

Create Product

POST /stripe/v1/products
Content-Type: application/x-www-form-urlencoded

name=Premium%20Plan&description=Monthly%20subscription

Prices

List Prices

GET /stripe/v1/prices?limit=10&active=true

Create Price

POST /stripe/v1/prices
Content-Type: application/x-www-form-urlencoded

unit_amount=1999&currency=usd&product=prod_XXX&recurring[interval]=month

Subscriptions

List Subscriptions

GET /stripe/v1/subscriptions?limit=10&status=active

Get Subscription

GET /stripe/v1/subscriptions/{subscriptionId}

Create Subscription

POST /stripe/v1/subscriptions
Content-Type: application/x-www-form-urlencoded

customer=cus_XXX&items[0][price]=price_XXX

Cancel Subscription

DELETE /stripe/v1/subscriptions/{subscriptionId}

Invoices

List Invoices

GET /stripe/v1/invoices?limit=10&customer=cus_XXX

Get Invoice

GET /stripe/v1/invoices/{invoiceId}

Charges

List Charges

GET /stripe/v1/charges?limit=10

Payment Intents

Create Payment Intent

POST /stripe/v1/payment_intents
Content-Type: application/x-www-form-urlencoded

amount=1999&currency=usd&customer=cus_XXX

Balance

Get Balance

GET /stripe/v1/balance

Events

List Events

GET /stripe/v1/events?limit=10&type=customer.created

Payment Methods

List Payment Methods

GET /stripe/v1/payment_methods?customer=cus_XXX&type=card

Attach Payment Method

POST /stripe/v1/payment_methods/{paymentMethodId}/attach
Content-Type: application/x-www-form-urlencoded

customer=cus_XXX

Detach Payment Method

POST /stripe/v1/payment_methods/{paymentMethodId}/detach

Coupons

List Coupons

GET /stripe/v1/coupons?limit=10

Create Coupon

POST /stripe/v1/coupons
Content-Type: application/x-www-form-urlencoded

percent_off=25&duration=once

Delete Coupon

DELETE /stripe/v1/coupons/{couponId}

Refunds

List Refunds

GET /stripe/v1/refunds?limit=10

Create Refund

POST /stripe/v1/refunds
Content-Type: application/x-www-form-urlencoded

charge=ch_XXX&amount=1000

Notes

• Stripe API uses form-urlencoded data for POST requests
• IDs are prefixed: cus_ (customer), sub_ (subscription), prod_ (product), price_ (price), in_ (invoice), pi_ (payment intent)
• Amounts are in cents (1999 = $19.99)
• Use expand[] parameter to include related objects; for list endpoints use expand[]=data.{field} (e.g., expand[]=data.customer)
• List endpoints support pagination with starting_after and ending_before
• Delete returns {id, deleted: true} on success
• Products with prices cannot be deleted, only archived (active=false)

Resources

• API Overview
• List Customers
• Get Customer
• Create Customer
• Update Customer
• Delete Customer
• Search Customers
• List Products
• Get Product
• Create Product
• Update Product
• Delete Product
• Search Products
• List Prices
• Get Price
• Create Price
• Update Price
• Search Prices
• List Subscriptions
• Get Subscription
• Create Subscription
• Update Subscription
• Cancel Subscription
• Resume Subscription
• Search Subscriptions
• List Invoices
• Get Invoice
• Create Invoice
• Update Invoice
• Delete Invoice
• Finalize Invoice
• Pay Invoice
• Send Invoice
• Void Invoice
• Search Invoices
• List Charges
• Get Charge
• Create Charge
• Update Charge
• Capture Charge
• Search Charges
• List Payment Intents
• Get Payment Intent
• Create Payment Intent
• Update Payment Intent
• Confirm Payment Intent
• Capture Payment Intent
• Cancel Payment Intent
• Search Payment Intents
• Get Balance
• List Balance Transactions
• Get Balance Transaction
• List Events
• Get Event
• Pagination
• Expanding Responses
• LLM Reference