Numero uses Webhooks to communicate updates on funds received via the Virtual Accounts you had initially created. Each time your customers send funds to the Virtual Account Number you have provided for them, Numero submits a POST request to the designated Webhook URL with information about the event transactions.
Your endpoint should respond to webhooks as quickly as possible. To acknowledge receipt of a webhook, your endpoint must return a 2xx HTTP status code. This status code should only indicate receipt of the message, not an acknowledgment that it was successfully processed by your system. Any other information returned in the response headers or response body is ignored.
Security
All Webhook requests are sent with a numero-webhook-secret header for verification. It should match the secret you passed when creating the webhook.
Retries & Failure
In a case where we are unable to reach the URL, all the webhooks will be retried.
Webhook URLs must respond with a status 200 OK or the request will be considered unsuccessful and retried.
Sample webhook format
The JSON payload below is a sample response of a webhook event that gets sent to your webhook URL.
{
"accountNumber":"9945634562",
"transactionDate":"30",
"currency":"NGN",
"transactionReference":"rtryr563554745eegege",
"sessionId":"000020564534558769978765309475",
"sourceAccountName":"Adeyemo Adeyemi",
"sourceAccountNumber":"0124653897",
"sourceBankName":"VFD Bank",
"tranRemarks":"Transfer for refund",
"transactionAmount":"1500.00"
}
Response
{
"requestSuccessful": true,
"responseMessage": "success",
"responseCode": "00",
"responseBody": {
"accountNumber":"9945634562",
"transactionReference": "rtryr563554745eegege",
"sessionId":"000020564534558769978765309475"
}
}