Which webhook events does Fynex send?

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.

Fynex sends webhooks for payments, payment links, subscriptions, promo codes, and business verification (KYB). Every event uses the same envelope, is signed, and is delivered to the URL you configure for your seller account.

The envelope

{
  "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.
Was this helpful?
Book a demo