Stripe Integration

HookFlow provides seamless integration with Stripe webhooks to help you reliably process payment events. This guide will walk you through setting up and configuring Stripe webhooks with HookFlow.

Setting Up Stripe Webhooks

Follow these steps to configure your Stripe webhooks:

1. Get Your HookFlow Endpoint

First, copy your unique HookFlow endpoint URL from your dashboard. This is where Stripe will send webhook events.

2. Configure Webhook in Stripe Dashboard

Log in to your Stripe Dashboard
Go to Developers → Webhooks
Click "Add endpoint"
Paste your HookFlow endpoint URL
Select the events you want to receive
Save the configuration

3. Add Stripe Signing Secret

After creating the webhook, Stripe will provide a signing secret. Add this to your HookFlow dashboard under the Stripe integration settings to verify webhook authenticity.

Supported Events

HookFlow supports all Stripe webhook events. Some commonly used events include:

payment_intent.succeeded
payment_intent.payment_failed
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.paid
invoice.payment_failed

Event Format

Stripe webhook events follow a consistent format. Here's an example of a payment_intent.succeeded event:

{
  "id": "evt_...",
  "object": "event",
  "type": "payment_intent.succeeded",
  "data": {
    "object": {
      "id": "pi_...",
      "amount": 2000,
      "currency": "usd",
      "status": "succeeded"
      // ... additional payment details
    }
  }
}

Best Practices

Follow these best practices when working with Stripe webhooks:

Always verify webhook signatures using the Stripe signing secret
Set up appropriate retry rules for failed webhook deliveries
Monitor webhook activity in your HookFlow dashboard
Test webhook handling in development using Stripe's test mode

Next Steps

Now that you've set up Stripe webhooks, explore these related topics:

Filtering Webhooks - Control which Stripe events are forwarded
Transforming Webhooks - Modify Stripe payloads before delivery
Retry Configuration - Set up reliable delivery with retries