Stripe

Manage Stripe customers, payments, invoices, and subscriptions from a workflow. Calls the Stripe REST API directly — no Stripe SDK required at the workflow level.

Setup

Get your secret key from the Stripe Dashboard (use a test key sk_test_... during development).

Add it as an environment variable on the Env Vars page:

| Variable | Description | |----------|-------------| | STRIPE_SECRET_KEY | Stripe secret API key (e.g. sk_live_... or sk_test_...) |

Never expose your secret key in workflow settings or code. Always use environment variables via {{ env.STRIPE_SECRET_KEY }} bindings or the Env Vars page.

Operations

Each node run executes a single operation.

create_customer

Create a new Stripe customer.

| Field | Type | Required | Description | |-------|------|----------|-------------| | operation | enum | Yes | create_customer | | customer_email | string | No | Customer email address. | | customer_name | string | No | Customer display name. |

create_payment_intent

Create a payment intent for a one-time charge.

| Field | Type | Required | Description | |-------|------|----------|-------------| | operation | enum | Yes | create_payment_intent | | amount | number | Yes | Amount in cents (e.g. 2000 for $20.00). | | currency | string | No | ISO currency code (default usd). | | customer_id | string | No | Existing Stripe customer ID to attach. |

list_invoices

List invoices for a customer.

| Field | Type | Required | Description | |-------|------|----------|-------------| | operation | enum | Yes | list_invoices | | customer_id | string | Yes | Stripe customer ID. |

create_subscription

Create a subscription for a customer.

| Field | Type | Required | Description | |-------|------|----------|-------------| | operation | enum | Yes | create_subscription | | customer_id | string | Yes | Stripe customer ID. | | price_id | string | Yes | Stripe Price ID (e.g. price_...). |

retrieve_balance

Retrieve the current Stripe account balance.

| Field | Type | Required | Description | |-------|------|----------|-------------| | operation | enum | Yes | retrieve_balance |

As an AI Agent Tool

Connect a Stripe node to an AI Agent Tools handle to let the agent look up billing information or create customers on demand.

Use Allowed Operations (Agent) to restrict which Stripe actions the agent can perform — for example, allow list_invoices and retrieve_balance but exclude create_payment_intent and create_subscription. This setting is excluded from the tool schema.

When used as a tool, the agent supplies operation and the relevant fields as tool arguments.

Output

All operations emit a result object on the result handle, accessible downstream as {{ stripe.* }}:

| Field | Type | Description | |-------|------|-------------| | success | boolean | Whether the operation succeeded | | id | string | Stripe resource ID (customer, payment intent, subscription, etc.) | | data | object | Raw Stripe API response payload | | error | string | Error message if success is false |

{
  "success": true,
  "id": "cus_abc123",
  "data": { "email": "[email protected]", "name": "Jane Doe" },
  "error": null
}
On this page