Ambassly Com Webhooks

generated: '2026-11-01'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://ambassly.com/docs/webhook-setup
sources:
- https://ambassly.com/docs/webhook-setup
- https://ambassly.com/blog/stripe-webhook-events-affiliates
- https://ambassly.com/blog/stripe-affiliate-tracking
description: Ambassly uses Stripe webhooks to track affiliate referrals and commissions.
events:
- event: checkout.session.completed
  description: Creates the Ambassly referral by resolving the referral code from the Checkout Session's client_reference_id or metadata.ambassly
    and links the referral to the Stripe customer.
- event: invoice.paid
  description: Creates a pending commission when the Stripe customer maps to a referral and the invoice is within the program's commission window.
- event: charge.refunded
  description: Claws back matching pending or approved commissions when the charge is refunded.
- event: customer.subscription.deleted
  description: Claws back matching pending or approved commissions when the subscription is deleted.
delivery:
  signature: Stripe-Signature header
  content_type: raw request body must be used for verification against the per‑company signing secret (whsec_…) saved in Ambassly
note: Ambassly verifies each request with Stripe's webhook signature and treats duplicate deliveries as idempotent; Stripe retries events when
  a non‑2xx response is returned.
docs: https://ambassly.com/docs/webhook-setup