Events
Overview
PaySG generates event data that you can use to inform you of activity on your payment service. When an event occurs, PaySG generates a new Event object. For example, when a payer pays on PaySG, you receive payment.succeeded
event.
By registering webhook endpoints in your payment service, you enable PaySG to automatically send Event objects as part of POST requests to the registered webhook endpoint hosted by your application.
Event Object
The Event object we send to your webhook endpoint provides a snapshot of the object that changed.
Currently, we only support the payment.succeeded
event type.
Example event payload
Why event object gets generated
This table describes different scenarios that trigger generating events.
Event delivery behaviours
This section provides documentation on the different behaviors that you can expect when PaySG sends events to your webhook endpoint. Specifically, it covers event retry deliveries and event ordering.
Retry behaviour
PaySG attempts to deliver an event to your webhook endpoint for up to 3 days with an exponential back off.
If your endpoint has been deleted when PaySG attempts a retry, future retries of that event will be prevented.
Event ordering
PaySG doesn’t guarantee delivery of events in the order in which they’re generated.
Your endpoint should not expect delivery of events in order, and needs to handle out-of-order delivery accordingly.
Last updated