Stripe Integration

Dispatch integrates with Stripe to receive webhook events for charges, payments, subscriptions, and more.

Connecting Stripe

1. Navigate to your project's Sources page
2. Click Connect Stripe
3. Authorize with your Stripe account
4. Select the Stripe events you want to receive

Dispatch will:

• Create a webhook endpoint with provider = "stripe"
• Register a webhook endpoint in your Stripe Dashboard
• Set the signing secret to your Stripe webhook's signing secret

Manual Setup

If you prefer to configure the endpoint manually:

1. Create a webhook endpoint in your Stripe Dashboard
2. Set the endpoint URL to your Dispatch endpoint URL
3. Copy the Signing secret (starts with whsec_) from the Stripe webhook page
4. Create a Dispatch source and paste the signing secret into the Signing Secret field

Supported Stripe Events

The event type is extracted from the type field in the Stripe payload (e.g., payment_intent.succeeded).

Category	Events
Charges	charge.succeeded, charge.failed, charge.refunded
Payment Intents	payment_intent.succeeded, payment_intent.payment_failed, payment_intent.created, payment_intent.canceled
Subscriptions	customer.subscription.created, customer.subscription.updated, customer.subscription.deleted
Invoices	invoice.paid, invoice.payment_failed, invoice.finalized
Customers	customer.created, customer.updated, customer.deleted
Checkout	checkout.session.completed, checkout.session.expired

Stripe can send any event type — configure your Stripe webhook to send only the events you need.

Signature Verification

Stripe webhooks include a Stripe-Signature header. Dispatch verifies this automatically using your webhook's signing secret.

Stripe-Signature: t=1614556800,v1=...

Use the signing secret exactly as shown in your Stripe Dashboard — it begins with whsec_.

Auto-Formatted Embeds

When no custom template is assigned, Dispatch auto-detects Stripe payloads and generates specialized embeds:

Charge Events

• Shows amount, currency, and status
• Includes customer email and payment method details

Payment Intent Events

• Shows amount, currency, and intent status
• Includes failure reason for failed payments

Subscription Events

• Shows plan name, interval, and customer
• Color-coded by action (green for created, blue for updated, red for canceled)

Invoice Events

• Shows amount due, due date, and customer
• Includes line item count

Disconnecting

To disconnect Stripe:

1. Go to Sources and find the Stripe endpoint
2. Click Disconnect
3. Dispatch deactivates the endpoint; you should also delete the webhook endpoint from your Stripe Dashboard