Stripe

Payments integration · 56 node(s) including 1 trigger.

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Stripe

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Balance

Balance: Get

stripe/balance_get · Action

Retrieve the current Stripe account balance.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…

Returns: tool_result, id, result, success, error

03Charge

Charge: Get

stripe/charge_get · Action

Retrieve a Stripe charge by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Charge ID	`string`	Required	ch_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Charge: List

stripe/charge_list · Action

List Stripe charges, optionally filtered by customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`		Filter by customer (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

04Checkout

Checkout Session: Create

stripe/checkout_session_create · Action

Create a Stripe Checkout Session and return its hosted payment URL.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Mode	`string`		payment — choices: Payment, Subscription, Setup
Success URL	`string`	Required	https://example.com/success
Cancel URL	`string`		https://example.com/cancel
Customer	`string`		cus_…
Line Items	`key_value_array`		price_id → quantity

Returns: tool_result, id, url, result, success, error

Checkout Session: Expire

stripe/checkout_session_expire · Action

Expire an open Stripe Checkout Session so it can no longer be completed.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Session ID	`string`	Required	cs_…

Returns: tool_result, id, result, success, error

Checkout Session: Get

stripe/checkout_session_get · Action

Retrieve a Stripe Checkout Session by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Session ID	`string`	Required	cs_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, url, result, success, error

Checkout Session: List

stripe/checkout_session_list · Action

List Stripe Checkout Sessions, optionally filtered by customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer	`string`		Filter by customer ID (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

05Coupon

Coupon: Create

stripe/coupon_create · Action

Create a Stripe coupon (percent-off or amount-off discount).

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Name	`string`		Displayed to customers on invoices/receipts
Percent Off	`integer`		Percentage discount 1–100 (leave blank for amount off)
Amount Off	`money`		e.g. 12.34 (requires a currency)
Currency	`string`		Required when Amount Off is set, e.g. gbp
Duration	`string`		choices: Once, Repeating, Forever
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the coupon
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Coupon: List

stripe/coupon_list · Action

List Stripe coupons.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

06Customer

Customer: Create

stripe/customer_create · Action

Create a Stripe customer. Returns the customer ID and object.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Email	`string`		customer@example.com
Name	`string`		Ada Lovelace
Phone	`string`		+44 20 7946 0000
Description	`string`
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the customer
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Customer: Delete

stripe/customer_delete · Action

Permanently delete a Stripe customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`	Required	cus_…

Returns: tool_result, id, result, success, error

Customer: Get

stripe/customer_get · Action

Retrieve a Stripe customer by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`	Required	cus_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Customer: List

stripe/customer_list · Action

List Stripe customers, optionally filtered by email.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Email	`string`		Filter by exact email (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Customer: Update

stripe/customer_update · Action

Update fields on an existing Stripe customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`	Required	cus_…
Email	`string`
Name	`string`
Phone	`string`
Description	`string`
Metadata	`key_value_array`

Returns: tool_result, id, result, success, error

07Dispute

Dispute: Close

stripe/dispute_close · Action

Close a Stripe dispute, acknowledging it as lost. Irreversible.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Dispute ID	`string`	Required	dp_…

Returns: tool_result, id, result, success, error

Dispute: Get

stripe/dispute_get · Action

Retrieve a Stripe dispute by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Dispute ID	`string`	Required	dp_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Dispute: List

stripe/dispute_list · Action

List Stripe disputes, optionally filtered by charge or payment intent.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Charge ID	`string`		Filter by charge (optional)
Payment Intent ID	`string`		Filter by payment intent (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

08Invoice

Invoice: Create

stripe/invoice_create · Action

Create a draft Stripe invoice for a customer. Returns the invoice ID and object.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer	`string`	Required	cus_…
Description	`string`
Auto Advance	`boolean`		Automatically finalise and attempt collection
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the invoice
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Invoice: Finalize

stripe/invoice_finalize · Action

Finalise a draft Stripe invoice, making it ready to pay or send.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Invoice ID	`string`	Required	in_…

Returns: tool_result, id, result, success, error

Invoice: Get

stripe/invoice_get · Action

Retrieve a Stripe invoice by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Invoice ID	`string`	Required	in_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Invoice: List

stripe/invoice_list · Action

List Stripe invoices, optionally filtered by customer or status.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer	`string`		Filter by customer ID (optional)
Status	`string`		draft, open, paid, uncollectible, void (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Invoice: Pay

stripe/invoice_pay · Action

Attempt to collect payment on a Stripe invoice out of the normal schedule.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Invoice ID	`string`	Required	in_…

Returns: tool_result, id, result, success, error

Invoice: Send

stripe/invoice_send · Action

Manually send a Stripe invoice to the customer by email.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Invoice ID	`string`	Required	in_…

Returns: tool_result, id, result, success, error

Invoice: Void

stripe/invoice_void · Action

Void a finalised Stripe invoice. This cannot be undone.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Invoice ID	`string`	Required	in_…

Returns: tool_result, id, result, success, error

09Payment

Payment Intent: Cancel

stripe/payment_intent_cancel · Action

Cancel a Stripe PaymentIntent that has not yet completed.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Intent ID	`string`	Required	pi_…
Cancellation Reason	`string`		duplicate, fraudulent, requested_by_customer or abandoned

Returns: tool_result, id, result, success, error

Payment Intent: Capture

stripe/payment_intent_capture · Action

Capture the funds of an authorised Stripe PaymentIntent.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Intent ID	`string`	Required	pi_…
Amount to Capture	`money`		e.g. 12.34 — defaults to the full capturable amount

Returns: tool_result, id, result, success, error

Payment Intent: Create

stripe/payment_intent_create · Action

Create a Stripe PaymentIntent to collect a payment. Returns the intent ID and object.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Amount	`money`	Required	e.g. 12.34
Currency	`string`	Required	gbp
Customer ID	`string`		cus_…
Payment Method	`string`		pm_…
Description	`string`
Confirm Immediately	`boolean`
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the payment intent
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Payment Intent: Get

stripe/payment_intent_get · Action

Retrieve a Stripe PaymentIntent by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Intent ID	`string`	Required	pi_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Payment Intent: List

stripe/payment_intent_list · Action

List Stripe PaymentIntents, optionally filtered by customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`		Filter by customer (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Payment Intent: Update

stripe/payment_intent_update · Action

Update fields on an existing Stripe PaymentIntent.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Intent ID	`string`	Required	pi_…
Amount	`money`		e.g. 12.34
Description	`string`
Metadata	`key_value_array`

Returns: tool_result, id, result, success, error

Payment Method: Attach

stripe/payment_method_attach · Action

Attach a Stripe payment method to a customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Method ID	`string`	Required	pm_…
Customer ID	`string`	Required	cus_…

Returns: tool_result, id, result, success, error

Payment Method: Detach

stripe/payment_method_detach · Action

Detach a Stripe payment method from its customer.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Method ID	`string`	Required	pm_…

Returns: tool_result, id, result, success, error

Payment Method: Get

stripe/payment_method_get · Action

Retrieve a Stripe payment method by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Method ID	`string`	Required	pm_…

Returns: tool_result, id, result, success, error

Payment Method: List

stripe/payment_method_list · Action

List a customer's Stripe payment methods by type.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`	Required	cus_…
Type	`string`		Payment method type (default card)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

10Payout

Payout: Create

stripe/payout_create · Action

Create a Stripe payout to your bank account or debit card.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Amount	`money`	Required	e.g. 12.34
Currency	`string`	Required	Three-letter ISO currency code, e.g. gbp
Description	`string`		Arbitrary string shown to users
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the payout
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Payout: Get

stripe/payout_get · Action

Retrieve a Stripe payout by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payout ID	`string`	Required	po_…

Returns: tool_result, id, result, success, error

Payout: List

stripe/payout_list · Action

List Stripe payouts, optionally filtered by status.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Status	`string`		Filter by status: pending, paid, failed, canceled (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

11Price

Price: Create

stripe/price_create · Action

Create a Stripe price for a product. Returns the price ID and object.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Product ID	`string`	Required	prod_…
Unit Amount	`money`	Required	e.g. 12.34
Currency	`string`	Required	gbp
Recurring Interval	`string`		choices: One-off, Daily, Weekly, Monthly, Yearly
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the price
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Price: Get

stripe/price_get · Action

Retrieve a Stripe price by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Price ID	`string`	Required	price_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Price: List

stripe/price_list · Action

List Stripe prices, optionally filtered by product or active state.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Product ID	`string`		Filter by product (optional)
Active	`boolean`		Filter by active state (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Price: Update

stripe/price_update · Action

Update mutable fields (active, nickname, metadata) on a Stripe price.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Price ID	`string`	Required	price_…
Active	`boolean`
Nickname	`string`
Metadata	`key_value_array`

Returns: tool_result, id, result, success, error

12Product

Product: Create

stripe/product_create · Action

Create a Stripe product. Returns the product ID and object.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Name	`string`	Required	Premium Plan
Description	`string`
Active	`boolean`
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the product
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Product: Get

stripe/product_get · Action

Retrieve a Stripe product by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Product ID	`string`	Required	prod_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Product: List

stripe/product_list · Action

List Stripe products, optionally filtered by active state.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Active	`boolean`		Filter by active state (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Product: Update

stripe/product_update · Action

Update fields on an existing Stripe product.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Product ID	`string`	Required	prod_…
Name	`string`
Description	`string`
Active	`boolean`
Metadata	`key_value_array`

Returns: tool_result, id, result, success, error

13Promotion

Promotion Code: Create

stripe/promotion_code_create · Action

Create a customer-facing promotion code for a Stripe coupon.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Coupon ID	`string`	Required	The coupon this code applies
Code	`string`		Customer-facing code (leave blank to auto-generate)
Active	`boolean`		Whether the promotion code is currently active
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the promotion code
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Promotion Code: List

stripe/promotion_code_list · Action

List Stripe promotion codes, optionally filtered by coupon or active state.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Coupon ID	`string`		Filter by coupon (optional)
Active	`boolean`		Filter by active state (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

14Refund

Refund: Create

stripe/refund_create · Action

Refund a Stripe charge or payment intent, in full or part.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Payment Intent	`string`		pi_…
Charge	`string`		ch_…
Amount	`money`		e.g. 12.34 — omit for a full refund
Reason	`string`		duplicate, fraudulent or requested_by_customer
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the refund
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Refund: Get

stripe/refund_get · Action

Retrieve a Stripe refund by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Refund ID	`string`	Required	re_…

Returns: tool_result, id, result, success, error

Refund: List

stripe/refund_list · Action

List Stripe refunds, optionally filtered by charge or payment intent.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Charge	`string`		Filter by charge ID (optional)
Payment Intent	`string`		Filter by payment intent ID (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

15Subscription

Subscription: Cancel

stripe/subscription_cancel · Action

Cancel a Stripe subscription immediately.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Subscription ID	`string`	Required	sub_…

Returns: tool_result, id, result, success, error

Subscription: Create

stripe/subscription_create · Action

Create a Stripe subscription for a customer from price/quantity items.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`	Required	cus_…
Line Items	`key_value_array`		Price ID → quantity
Metadata	`key_value_array`		Arbitrary key → value pairs stored on the subscription
Idempotency Key	`string`		Optional — safely retry the same create

Returns: tool_result, id, result, success, error

Subscription: Get

stripe/subscription_get · Action

Retrieve a Stripe subscription by ID.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Subscription ID	`string`	Required	sub_…
Expand	`string`		Comma-separated fields to expand (optional)

Returns: tool_result, id, result, success, error

Subscription: List

stripe/subscription_list · Action

List Stripe subscriptions, optionally filtered by customer and status.

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Customer ID	`string`		Filter by customer (optional)
Status	`string`		active, canceled, all, etc. (optional)
Limit	`integer`		Max results (default 20, max 100)

Returns: tool_result, results, count, has_more, success, error

Subscription: Update

stripe/subscription_update · Action

Update a Stripe subscription (cancel at period end, metadata).

Field	Type		Details
Stripe Secret Key	`secret`	Required	sk_live_… or sk_test_…
Subscription ID	`string`	Required	sub_…
Cancel At Period End	`boolean`
Metadata	`key_value_array`

Returns: tool_result, id, result, success, error

16Triggers

Stripe Webhook Trigger

trigger/stripe_webhook · Trigger

Triggers a flow when a Stripe webhook event is received (payment, subscription, invoice…)

Field	Type		Details
Signing Secret	`secret`	Required	whsec_… (from the Stripe webhook endpoint)
Event Filter	`string`		Comma-separated, e.g. payment_intent.succeeded,checkout.session.completed,invoice.paid (blank = all)

Returns: content, event_type, event_id, object_type, object_id, customer_id, amount, currency, status, body, triggered_at

17Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Monetary amounts are always expressed in the smallest unit of the currency (for example cents for USD or pence for GBP), so charging $10.00 means entering 1000, not 10.
New invoices are created as drafts and must be finalised before they can be sent or paid; once finalised an invoice can only be voided, never edited.
Voiding a finalised invoice, closing a dispute, and expiring a Checkout Session are permanent and cannot be undone.
Deleting a customer is permanent and immediately cancels any active subscriptions belonging to that customer.
The cancel-subscription action ends the subscription straight away; to stop it at the end of the current billing period, use the update-subscription action instead.
A payment method must be attached to a customer before it can be charged again or reused on future invoices.