Bills & Transfers Webhook
Just as mentioned earlier there is a score of the currently supported webhook event types and below are examples of their payload.
Transfer Success Payload Example
{
"merchant_ref":"202209082013GAEGBCB",
"meta": {
"account_name":"John Doe Company,
"account_number":"12345678911",
"narration":"transfer narration",
"currency":"NGN",
"amount":5000
},
"trx_ref":"202209082013HEIBIFD",
"secret":"your_webhook_secret_key",
"status":"successful",
"session_id":"090305220908201401138651852193",
"type":"transfer",
"response":"Transfer successful"
}
Transfer Failed & Reverse Payload Example
{
"merchant_ref":"8267995",
"meta":
{
"account_name":"JOHN DOE",
"account_bank":null,
"account_number":"208343221248",
"narration":"Transfer",
"currency":"NGN","amount":200},
"trx_ref":"202208090425BAAFJHI",
"secret":"your_secret_key",
"status":"failed",
"type":"transfer",
"response":"Transfer failed"
}
Electric Bill Payment Payload Example
{
"merchant_ref":"123456",
"meta":{
"amount":1000,
"phone_number":"0701234556789",
"reference":"2324252627282920",
"merchant_ref":"123456",
"meter_number":"45298282890",
"service":"EKEDC",
"customer_name":"JOHN DOE",
"customer_address":"A STREET IN YOUR STREET",
"meter_type":"Prepaid",
"currency":"NGN",
"electricity_token":"645653567563535356537"
},
"reference":"2761819744609277",
"secret":"1828393930293094938",
"status":"successful",
"type":"electricity",
"response":"Electricity recharge successful"
}
Electricity-Reverse Payload Example
{
"merchant_ref":"123456",
"meta":
{
"amount":500,
"phone_number":null,
"reference":"434524242524534343",
"merchant_ref":"123456",
"meter_number":"36294719436",
"service":"EKEDC",
"customer_name":"JANET DOE",
"customer_address":"A LITTLE STREET IN OAKTOWN",
"meter_type":"Prepaid",
"currency":"NGN"},
"reference":"3423242423434339",
"secret":"4532523424524234",
"status":"failed",
"type":"electricity",
"response":"Electricity recharge failed"
}
Collections Webhook Payload Example
{
"type":"collection",
"amount":300,
"session_id":"000012221112104439180319952000",
"account_number":"43453232423",
"source":
{
"account_number":"0435646022",
"first_name":"JANE",
"last_name":"DOE",
"narration":"Jane Doe ",
"bank":"POLARIS BANK",
"bank_code":"000012",
"createdAt":"2022-11-12 9:46:8"
},
"secret":"your_secret_key"
}
Updated 16 days ago