- Use the dashboard or the Create Webhook endpoint to subscribe to a single or multiple events.
- If you have decided to opt in for webhook signature verification, implement your application logic for Webhook Event Signature Verification.
- Enable your webhook subscription through the Update Webhook endpoint if you haven’t already done so.
- Trigger events by Creating a payment to test the logic for receiving events from Paylias. You can view event delivery logs and delivery-errors both through the API as well as on the dashboard.
Subscribing to events
Events in Paylias are structured as a JSON object with two keys:record_type
: This is the resource for which the event is being triggeredevent_type
: This is the operation on the resource that triggered the event.
record_type
s and event_type
s
record_type | EK_Created | EK_Updated |
---|---|---|
RT_Payments | yes | yes |
RT_PaymentSubmissions | yes | yes |
RT_PaymentAdmissions | yes | yes |
RT_PaymentAdmissionTasks | yes | yes |
RT_Error | yes | no |
RT_Transactions | yes | no |
record_type:event_type
depending on your own internal use cases and logic handling.
While a single endpoint can subscribe to multiple events, an event can only be subscribed to a single endpoint. This means that if you already have an active subscription for a specific combination of
record_type:event_type
for example RT_Payments:EK_Created
, you cannot resubscribe to this event through another endpoint.