Stripe

The Stripe integration lets your workflows create payments, manage customers, handle subscriptions and listen to events—without writing custom code.

How to connect

Secret API Key

The Stripe node authenticates requests with a secret API key. Obtain it from Stripe → Developers → API keys and paste it into the Stripe credential in Helios. Both test and live keys are supported—remember that data is isolated per environment.

Webhooks (Trigger only)

• After creating the integration, reopen it to add a Stripe Trigger.
• Copy the webhook URL generated by Helios.
• In your Stripe dashboard (Developers → Webhooks) click + Add endpoint, paste the URL and pick the events you want to forward (e.g. invoice.payment_succeeded).
• Stripe will display a signing secret—copy it and paste it back into the Helios integration, then save.
• Add integration trigger to your workflow.

Once saved, the selected Stripe events will trigger your workflow in real time.

Permissions

The node can only perform the actions allowed by your API key. Generate a key in Stripe with the minimum required scopes (e.g. read_write on Payments, Customers, etc.) and paste it into Helios. Any operation outside those scopes will be rejected by Stripe.

Functionality

As Trigger Node

Receive real-time events such as invoice.payment_succeeded or customer.created. Use the natural-language filter prompt to run the workflow only for relevant events. For example, “When a payment fails for invoices over $100”.

As Integration Node

Inside a workflow you can perform any Stripe API call, for example:

• Create or confirm a PaymentIntent
• Issue a refund
• Fetch a list of customers
• Update a subscription item

See the full list of operations in the Stripe API reference.

Outputs

The Stripe node returns the full response from the Stripe API. You can reference the output in other nodes using the [[nodes["stripe_node_name"].output]] syntax in prompts.

Limitations

• Standard Stripe API rate limits apply.
• Test and live modes are completely separate—keys and data do not overlap.

✅ What you can do

• Invoke any REST endpoint exposed by Stripe.
• Listen to any event emitted via webhooks.

❌ What you can't do

• Perform actions that require Stripe Connect OAuth (e.g. acting on behalf of a connected account).