HandleEvent​Handle​Event

Handle Stripe Webhook Events.

This task receives a Stripe webhook payload, validates the signature, and outputs the parsed event.

yaml
type: "io.kestra.plugin.stripe.webhook.HandleEvent"

Receive a Stripe webhook

yaml
id: stripe_webhook
namespace: company.team

tasks:
  - id: handle_webhook
    type: io.kestra.plugin.stripe.webhook.HandleEvent
    apiKey: "{{ secret('STRIPE_API_KEY') }}"
    payload: "{{ trigger.payload }}"
    signatureHeader: "{{ trigger.headers['Stripe-Signature'] }}"
    endpointSecret: "{{ secret('STRIPE_WEBHOOK_SECRET') }}"
Properties

Stripe API Key

Secret key for authenticating with Stripe. Starts with 'sk_' for live/test keys.

Endpoint secret configured in Stripe for webhook validation

Raw webhook payload from Stripe

Stripe-Signature header

Event data object

Stripe event ID

Raw payload of the webhook