Stripe
Accept payments, manage subscriptions, and handle billing for the authenticated user's Stripe account. All monetary amounts are in the smallest currency unit (e.g., cents for USD). All operations act on the authenticated user's Stripe account.
Quick start
Tools (5)
GETlist-customers
Returns a paginated list of customers. Use the email parameter to find a specific customer. Results are sorted by creation date, newest first.
GET /v1/customers
Parameters
email
|
string |
limit
|
integer |
starting_after
|
string |
POSTcreate-customer
Creates a customer record. Use this before creating subscriptions or charges. The email field is not required but strongly recommended for identifying the customer later.
POST /v1/customers
Parameters
email
|
string |
name
|
string |
description
|
string |
metadata
|
object |
POSTcreate-payment
Initiates a payment. Returns a PaymentIntent object with a client_secret that can be used to confirm the payment on the frontend. Amount is in the smallest currency unit (e.g., 1000 = $10.00 USD). This does NOT charge the customer immediately — the payment must be confirmed separately.
POST /v1/payment_intents
Parameters
amount
|
integer required |
currency
|
string required |
customer
|
string |
description
|
string |
automatic_payment_methods
|
object |
POSTcreate-subscription
Starts a recurring billing subscription. The customer must already exist and have a payment method attached. The subscription will begin immediately and the customer will be charged according to the price's billing interval. This WILL charge the customer. Use with care.
POST /v1/subscriptions
Parameters
customer
|
string required |
items
|
array required |
GETget-balance
Returns the current balance of the Stripe account, broken down by currency. The available balance is what can be paid out. The pending balance is from recent charges that haven't settled yet. This is a read-only endpoint with no side effects.
GET /v1/balance