Stripe HandleEvent

Stripe HandleEvent

Certified

Validate and parse Stripe webhooks

Validates Stripe webhook signatures with the endpoint secret, then returns the event id/type plus the deserialized data map. Fails fast on signature mismatch; provide the raw request body and the Stripe-Signature header as received.

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') }}"

triggers:
  - id: webhook
    type: io.kestra.plugin.core.trigger.Webhook
    key: 4wjtkzwVGBM9yKnjm3yv8r
Properties

Stripe API Key

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

Webhook endpoint secret

Signing secret configured on the Stripe webhook endpoint; required for signature validation

Webhook payload body

Raw JSON request body from Stripe; must be unmodified for signature verification

Stripe-Signature header value

Exact Stripe-Signature header from the incoming request

Reference (ref) of the pluginDefaults to apply to this task.

Event data payload

Deserialized object map from event.data.object

Stripe event ID

Raw webhook payload

Original payload body returned for downstream auditing

More Plugins in this Category

Zulip
Zulip

Tasks that send messages to Zulip streams or users.

Business

2 tasks

3 blueprints

Zenduty
Zenduty

Tasks that create incidents in Zenduty.

Business

2 tasks

3 blueprints