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

Examples

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

apiKey *string

Stripe API Key

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

endpointSecret *string

Webhook endpoint secret

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

payload *string

Webhook payload body

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

signatureHeader *string

Stripe-Signature header value

Exact Stripe-Signature header from the incoming request

Outputs

data object

Event data payload

Deserialized object map from event.data.object

id string

Stripe event ID

raw string

Raw webhook payload

Original payload body returned for downstream auditing

Git

Tasks that clone, fetch, and interact with Git repositories.

InfrastructureBusiness

Todoist

Tasks that manage Todoist tasks through the Todoist API.

Business

Stripe HandleEventCertifiedValidate and parse Stripe webhooks

Stripe HandleEvent

More Plugins in this Category

Git

Todoist

Stripe HandleEvent
Certified
Validate and parse Stripe webhooks