Stripe webhook setup

Overview

Stripe webhooks let TrackLayer ingest subscription, invoice, and dispute signals without polling. You point Stripe at a signed TrackLayer endpoint, forward selected event types, and map them into commerce events your ad platforms understand.

Steps

1. In Stripe Developers → Webhooks, create an endpoint using the URL from Sources → Stripe in TrackLayer.
2. Select events: invoice.paid, customer.subscription.updated, charge.refunded as a starter kit.
3. Paste the signing secret into TrackLayer so payloads can be verified.

stripe listen --forward-to https://hooks.tracklayer.io/v1/stripe/workspace_123

4. Trigger test events from the Stripe CLI and confirm TrackLayer normalizes them to SubscriptionRenewed, Chargeback, etc.

Troubleshooting

• 401 signature failures: whitespace or proxy rewrites mutate bodies—disable buffering on CDNs for this path.
• Missing metadata: enrich with client_reference_id and metadata.tl_user_id during checkout session creation.
• Duplicate deliveries: Stripe retries; rely on TrackLayer idempotency keys computed from Stripe event.id.