Webhooks

Webhooks allow you to receive real-time notifications when a transaction is completed. Configure your URL in the API Settings.

Webhook Integration

When an event occurs, we send a HTTP POST request to your URL with a JSON body.

// Sample Success Payload
        {
            "event": "transaction.success",
            "service": "data",
            "reference": "FV-98234109",
            "amount": 500,
            "recipient": "08012345678",
            "status": "success",
            "date": "31-01-2026 18:50:44"
        }

Security: Always verify that the notification is coming from our IP address or include a unique secret in your URL to prevent spoofing.