Skip to content

Stripe Trigger

Triggers a workflow when events occur in your Stripe account. Webhook endpoints are automatically registered with Stripe when the workflow is published — no manual setup required.

Requires a Stripe connection with a valid API key.

Configuration

FieldDescriptionNotes
ConnectionStripe connection to useRequired
EventsStripe event types to subscribe toRequired. Multiple selection. Use All events to receive every event type.

Common Events

EventDescription
payment_intent.succeededPayment intent succeeded
payment_intent.payment_failedPayment intent failed
charge.succeededCharge succeeded
charge.failedCharge failed
charge.refundedCharge refunded
checkout.session.completedCheckout session completed
invoice.paidInvoice paid
invoice.payment_failedInvoice payment failed
customer.createdCustomer created
customer.subscription.createdSubscription created
customer.subscription.deletedSubscription cancelled
dispute.createdDispute created

Stripe's full event catalogue is available in the Stripe API reference.

Output

The trigger passes the full Stripe event payload to downstream nodes:

FieldDescription
bodyParsed JSON payload from Stripe (event object)
body.typeEvent type (e.g., payment_intent.succeeded)
body.data.objectThe Stripe object that the event is about (Charge, PaymentIntent, etc.)
headers.Stripe-SignatureSignature header (already verified before the workflow runs)

How It Works

  1. You configure the trigger with a connection and a list of events.
  2. When you publish the workflow, the system calls Stripe's Create Webhook Endpoint API and stores both the returned endpoint ID and the signing secret.
  3. When you re-publish or delete the workflow, the old endpoint is deleted and a fresh one is created (with a new signing secret).
  4. Every incoming webhook is verified using Stripe's signature scheme: HMAC-SHA256 over {timestamp}.{rawBody} with the per-endpoint signing secret. Deliveries older than 5 minutes are rejected as replay attempts. Requests with missing or invalid signatures are rejected with 401 Unauthorized.

Security

The signing secret is generated by Stripe at registration time and stored only on the workflow's webhook record. It is never exposed in the UI or in workflow outputs. If you suspect the secret has leaked, unpublish and re-publish the workflow to rotate it.