Fiato sends Webhook Events to notify your server when specific transaction status updates occur.
Webhook events are triggered only when a transaction moves into either of the following states: processing – The transaction has been detected on the blockchain and is awaiting network confirmations. completed – The transaction has been fully confirmed and the payment is successful. Each webhook event includes a JSON payload containing the transaction reference, status, amount, currency, network, and timestamp. These events help your system automatically update order statuses, credit accounts, or trigger other business logic without requiring manual intervention.
NOTE : f-reference is the fiato's reference generated at the transaction initialization.
{
"status": "success",
"event": "received_crypto",
"f_reference": "SYBIU9Z0YIIG",
"payout_amount": 5000,
"payer_name": "Comfort Samuel",
"payer_email": [email protected],
"payment_status": "processing",
"open_time": 1762291775,
"coin": "usdt",
"wallet": "0xEAf0F17E833b950958332b0689C968231286561f",
"message": "crypto-currency received successfully"
}
{
"status": "success",
"event": "settlement_complete",
"f_reference": "SYBIU9Z0YIIG",
"payout_amount": 5000,
"payer_name": "Comfort Samuel",
"payer_email": [email protected],
"payment_status": "complete",
"open_time": 1762291775,
"coin": "usdt",
"wallet": "0xEAf0F17E833b950958332b0689C968231286561f",
"message": "fiat settled successfully"
}