Webhook Notification

We will send a POST request to your configured webhook URL when a payment event occurs (e.g., success, failure).

Webhook Method: POST https://yourdomain.com/webhook/payment

Content-Type: application/json

Headers:

X-Signature: Optional HMAC SHA256 signature (if enabled)

Sample Payload:

        
            
**POST Payload Example**
            
{
            
 "event": "payment.success",
            
 "message": "Payment received successfully",
            
 "data": {
            
  "trx_id": "BP2c7sAvw75MTlrP",
            
  "amount": "100.00",
            
  "currency": "NGN",
            
  "status": "successful",
            
  "reference": "REFZ9A3G8K116906001234",
            
  "timestamp": "2025-06-15T14:22:01Z",
            
  "customer": {
            
    "name": "John Doe",
            
    "email": "johndoe@example.com"
            
  }
            
 }
            
}