Receive real-time notifications about key events within the Fintegence system. Webhooks let you automate follow-up actions and react immediately to changes across onboarding, payments, transfers, exchanges, and compliance flows.Supported Events#
Webhooks cover a wide range of operational events across the platform. Open any event page to review its payload and behavior.User and KYC Webhooks#
User Balance Generation
Notifies you when a user's fiat balances become active after KYC completion.KYC File Added
Provides real-time feedback on the outcome of a user's KYC document upload.POA Verification Status
Sends updates about the Proof of Address verification lifecycle.KYC Verification Status
Delivers detailed status changes for the overall KYC verification process.High Risk KYC Verification
Additional notification for users flagged during high-risk verification review.Create Wallet
Dispatched when a new blockchain wallet is successfully created for a user.Transfers and Payments Webhooks#
P2P Transfer
Triggered when the status of an internal transfer between partner and user changes.IBAN Status
Notifies you whenever the status of a user's dedicated IBAN changes.Partner SEPA Transfer
Status updates for SEPA transfers initiated by the partner.User SEPA Transfer
Status updates for SEPA transfers initiated by the user.SEPA Deposit
Dispatched when a new SEPA deposit is successfully credited to a user's account.Crypto Withdrawal
Provides real-time notifications about the progress of a crypto withdrawal.Crypto Deposit
Covers the full lifecycle of an incoming crypto deposit.Exchange
Triggered when the status of a currency exchange changes.Card Transaction
Dispatched in real time for every successful transaction made with a user's card.Order Status
Sends order lifecycle updates, for example when the payment wallet is ready.Payment Link
Notifies you whenever the status of a payment link changes.Card Webhooks (Currently Suspended)#
Card services and associated card webhooks are currently suspended and unavailable.
Card 3DS Code (Suspended)
Service currently inactive. Delivers the one-time code for 3-D Secure authentication.Card Activation Code (Suspended)
Service currently inactive. Delivers the one-time activation code used when adding a card to a digital wallet.Security and Verification#
Before processing any webhook notification, always verify its authenticity. This is required for a secure and reliable integration.
Authentication Token Verification#
Every webhook request includes a shared secret token in the HTTP headers.2.
Verify it against your secret
Reject requests with missing or invalid tokens.
If needed, add extra replay protection such as timestamp or nonce validation in your own middleware.
Getting Your Secret Token#
Your webhook secret is provided together with your API credentials during integration setup. Store it securely and never expose it in client-side code.Delivery and Retry Policy#
Acknowledging Receipt#
Return any 2xx HTTP status code to confirm successful processing.Automatic Retry Mechanism#
If delivery fails, up to 4 additional attempts are made with increasing delays.| Attempt | Delay After Previous Failure | Status |
|---|
| 1st | - | Initial delivery |
| 2nd | ~8 seconds | First retry |
| 3rd | ~16 seconds | Second retry |
| 4th | ~32 seconds | Third retry |
| 5th | ~64 seconds | Final retry |
Retry Behavior#
Failure Condition: Non-2xx responses or timeouts trigger retries.
Exponential Backoff: Delay increases between attempts.
Timeout: Each request times out after 10 seconds.
Final State: After 5 failed attempts in total, the webhook is treated as permanently failed.
Troubleshooting#
| Problem | Cause | Solution |
|---|
| 401 Unauthorized | Invalid token | Verify your shared secret token |
| Timeouts | Slow processing | Return 200 immediately and process asynchronously |
