---
title: "Which webhook events does Fynex send?"
description: "Fynex sends events for payments, payment links, subscriptions, promo codes, and business verification. Each has the same envelope, is signed, and retries up to 3 times to allowlisted URLs."
url: "/docs/developers/which-webhook-events-does-fynex-send/"
category: "Developers"
---

Fynex sends webhooks for **payments, payment links, subscriptions, promo codes, and business verification (KYB)**. Every event uses the same envelope, is [signed](/docs/developers/how-do-i-verify-fynex-webhook-signatures/), and is delivered to the URL you configure for your seller account.

## The envelope

```json
{
  "eventId": "…",
  "eventType": "PaymentCompleted",
  "sellerAccountId": 123,
  "occurredAt": "2026-07-12T10:00:00Z",
  "payload": { }
}
```

## Events

**Payments**
- `PaymentCompleted`, `PaymentRefunded`

**Payment links**
- `PaymentLinkCreated`, `PaymentLinkUpdated`, `PaymentLinkPaid`, `PaymentLinkExpired`, `PaymentLinkCancelled`, `PaymentLinkEmailFailed`

**Subscriptions**
- `SubscriptionCreated`, `SubscriptionCharged`, `SubscriptionInstallmentCharged`, `SubscriptionTrialWillEnd`, `SubscriptionTrialEnded`, `SubscriptionCommitmentCompleted`, `SubscriptionCancelled`, `SubscriptionPastDue`

**Business verification (KYB)**
- `KYBVerificationStarted`, `KYBVerificationPending`, `KYBVerificationManualReview`, `KYBVerificationApproved`, `KYBVerificationRejected`, `KYBVerificationLevelChanged`

**Other**
- `PromoCodeRedeemed`, `TaxLocationResolved`

## Delivery and retries

- Events are delivered to the webhook URL on your seller account, over HTTPS.
- Delivery **times out at 10 seconds** and **retries up to 3 times** before it's marked failed. Return a 2xx quickly and do slower work afterwards.
- Destination URLs must be on your **allowlist** — add the URLs (or ranges) you'll receive on before you expect events.
- Handlers should be **idempotent**: treat `eventId` as the dedupe key, since a retry can deliver the same event more than once.

## Related

- [How do I verify Fynex webhook signatures?](/docs/developers/how-do-i-verify-fynex-webhook-signatures/)