Stripe to n8n Webhook Automation Integration Guide

Comparison matrix

ROI metrics

Deploying n8n to handle Stripe webhooks eliminates 38 hours of monthly developer maintenance spent building, updating, and debugging bespoke API receiver code across internal services.

Step-by-step setup guide

1. 1.Create Webhook Node in n8n

   Add a Webhook Trigger node in your n8n canvas. Set the HTTP Method to POST and define the path as 'stripe-events'. Set the Response Mode to 'Immediately' with status code 200 so Stripe does not mark requests as timed out while complex workflows execute.

   {
     "parameters": {
       "httpMethod": "POST",
       "path": "stripe-events",
       "responseMode": "responseNode",
       "options": {}
     },
     "name": "Stripe Webhook",
     "type": "n8n-nodes-base.webhook",
     "typeVersion": 1
   }

2. 2.Register Endpoint in Stripe Developer Dashboard

   Navigate to Stripe Dashboard > Developers > Webhooks > Add Endpoint. Paste your production n8n webhook URL (e.g., https://n8n.yourdomain.com/webhook/stripe-events) and select 'checkout.session.completed' from the event catalog.

   curl -X POST https://api.stripe.com/v1/webhook_endpoints \
     -u sk_live_your_stripe_secret_key: \
     -d "url"="https://n8n.yourdomain.com/webhook/stripe-events" \
     -d "enabled_events[]"="checkout.session.completed"

3. 3.Obtain Webhook Signing Secret

   Retrieve the signing secret (whsec_...) from the newly created webhook endpoint details page in Stripe. Store this value in n8n as an environment variable named STRIPE_WEBHOOK_SECRET.

4. 4.Verify Signature with a Crypto Node

   Use a Code node in n8n to parse the 'stripe-signature' header, extract timestamp 't' and signature 'v1', and compute an HMAC-SHA256 hash using the raw request body and STRIPE_WEBHOOK_SECRET to reject spoofed payloads.

   const crypto = require('crypto');
   const sigHeader = $input.item.json.headers['stripe-signature'];
   const parts = Object.fromEntries(sigHeader.split(',').map(p => p.split('=')));
   const signedPayload = `${parts.t}.${JSON.stringify($input.item.json.body)}`;
   const hmac = crypto.createHmac('sha256', process.env.STRIPE_WEBHOOK_SECRET).update(signedPayload).digest('hex');
   if (hmac !== parts.v1) throw new Error('Invalid Stripe signature');
   return $input.item;

5. 5.Process Customer Data and Provision Access

   Add conditional routing via the Switch or If node checking $json.body.type === 'checkout.session.completed'. Map customer_details.email, amount_total, and client_reference_id to downstream CRM, database, or notification nodes.

Webhook payload example

{
  "id": "evt_1O8qZ22eZvKYlo2CLP38kXYZ",
  "object": "event",
  "api_version": "2023-10-16",
  "created": 1698765432,
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": "cs_live_a1b2c3d4e5f6g7h8",
      "object": "checkout.session",
      "amount_subtotal": 10000,
      "amount_total": 10000,
      "currency": "usd",
      "customer": "cus_O8qZxyz123456",
      "customer_details": {
        "email": "alex.smith@example.com",
        "name": "Alex Smith"
      },
      "metadata": {
        "tier": "enterprise",
        "workspace_id": "ws_998877"
      },
      "mode": "subscription",
      "payment_status": "paid",
      "subscription": "sub_1O8qZ22eZvKYlo2CSub1234"
    }
  }
}

FAQ