The webhooks can provide immediate notifications for billing outcomes. The use of webhooks is dependent on the needs of the business. Ezypay has webhooks that can send out notifications for certain scenarios. For example: For failed payments or retrieving debits by date.
A public bin will be required in order for Ezypay to send all webhooks into
You can create a webhook (API) that will send a callback request to a URL of your choice in response to events that happen in Ezypay. The webhook will return a full response object containing all details of the object. For example, when a customer created event occurs, the webhook will return the details of the customer object created e.g. name, email, contact information and address.
Ezypay provides the following events and subscribed Webhooks can be configured to sent notifications when these events happen:
|customer_create||Event when a new customer is created.|
|customer_update||Event when a customer's details are updated.|
|invoice_created||Event after an invoice is created.|
|invoice_past_due||Event when an invoice status has changed to |
|invoice_paid||Event when an invoice status has changed to |
|subscription_create||Event when a new subscription is created.|
|subscription_cancel||Event when a subscription is cancelled.|
|subscription_activate||Event when a subscription is activated.|
|payment_method_invalid||Event when a customer's payment method becomes invalid. This event is only thrown when a valid payment method becomes invalid. If a payment method is invalid upon creation, no webhook event is triggered.|
|subscription_payment_reactivate||Event when a customer's subscription is reactivated. A customer's subscription can become deactivated because of past due invoices. When all invoices are resolved, the subscription will automatically reactivate.|
|credit_note_created||Event when a credit note is created. This event is triggered when a merchant moves funds to a customer usually as a refund or a dispute.|
|credit_note_paid||Event when a credit note is successfully paid. Credit note status changed to paid.|
|credit_note_failed||Event when a credit note transaction has failed. Credit note status changed to failed.|
|partner_invoice_created||Event after a partner invoice is created.|
|partner_invoice_paid||Event when a partner invoice status changed to |
|partner_invoice_past_due||Event when a partner invoice status has changed to |
How to create a webhook can be found here:
In an event whereby Ezypay fails to send a webhook to the integrator. Ezypay will try a maximum of 32 times only
If a webhook notification fails (i.e. endpoint does not return a 2xx HTTP or timeout response), Ezypay will automatically attempt to resend the webhook notification to your webhook URL. For the next 24 hours, Ezypay will resend the webhook notification every 60 mins after each fail attempt.
Each failed attempt will be recorded in the webhook event notification log in the order in which they were created, allowing for follow-up support action. You can retrieve the notification log by calling the List webhook notification log (API). Failed attempts can be identified as they will have the status = fail. The webhook notifications log will display the most up-to-date information on webhooks sent in the system.
You can test out a webhook to ensure it is working correctly by manually simulating a webhook event (API). You can specify what events will trigger the webhook response. A record of events will be created in the webhook notification log. You can view this log by calling the List webhook notification log (API)
You can retrieve a webbhook (API) to view details such as the events that have been assigned to trigger this webhook.
How to retrieve webhook details can be found here:
You can update a webhook (API) to make changes to an existing webhook such as:
- changing the callback URL
- adding or removing events that will trigger this webhook
How to update a webhook can be found here:
You can delete a webhook (API) that is no longer required.
How to delete a webhook can be found here:
Steps to setup your Ezypay POSTman environment:
Setting up Ezypay's webhooks collection
Incase of missing button, just click import on your POSTman application and select "Link":
Updated almost 2 years ago
Scenario 6: Settlement
The sixth scenario in the integration process