Step 6: Set Up Webhooks (Recommended)

Webhooks notify your system when payment status changes.

Available Events

Event	Description
`fund_settled`	When the fiat payin transaction is successful
`asset_settled`	When the crypto payin transaction is successful
`asset_failed`	When the crypto payin transaction has failed
`fund_failed`	When the fiat payin transaction has failed
`fund_processing`	When the fiat payin transaction is done by your user but TransFi has not yet received the confirmation of the final status
`initiated`	When the order is created but your user has not made an attempt of payment
`expired`	When no payment is received and the order expiry time elapses

Webhook Security

Webhooks are:

Triggered at every status update
Signed for security

All webhooks sent from TransFi are signed with a dedicated secret that is known only by TransFi and Customers. This ensures the integrity of the data contained in the webhook.

Where to Set the Webhook URL and Get the Webhook Secret Key?

You can set the Webhook URL and get the Webhook secret in:

Dashboard → Settings

[!WARNING] Common mistake: Relying only on redirects instead of webhooks. Redirects can be interrupted; webhooks are reliable.