A paid platform invoice of a referred creator earned the partner a commission.
When this fires
Stripe reported an invoice of a converted referral paid, inside the commission period: the converting invoice itself, every renewal after it, an addon invoice, and the fee invoices of a creator who later moved to Free. One event per invoice. The commission is priced from the invoice's total before tax and after any discount, so the referred creator's 20% off their first three months lowers the first three commissions: a Starter month earns "9.3600" on a "31.2000" base, then "11.7000" on "39.0000".
Money waits. A commission is born pending behind a 30-day hold, so a refund inside the window can take it back; hold_until says when it becomes payable.
Caveats
- A redelivered invoice earns nothing twice. A second invoice.paid for the same invoice finds its row and writes no other.
- A suspended partner earns nothing, and the invoice is not revisited when they are reinstated.
- A referral under review earns silently. Its rows are written but not announced until the review is decided.
Related events
- partner.reward_approved: the hold passes.
- partner.reward_reversed: a refund takes it back.
Headers
t=<unix seconds>,v1=<hex>: the HMAC-SHA256 of "<t>.<raw body>" under the endpoint's secret. Verify it before acting, and refuse a t more than 300 seconds from now. During a secret rotation a v0= signature under the previous secret may precede v1=.
The event's ULID, bare. The envelope's id is the same ULID prefixed evt_, so strip the prefix before comparing. Deduplicate on it: a retry carries the same id.
The event name, the same as the envelope's type.
Always application/json.
Always Subscriby-Webhooks/1.0.
Payload
Response
Your endpoint acknowledged the delivery. Any 2xx status within 30 seconds marks it delivered; the response body is ignored.
Changes
Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.