Paylias’s Webhooks API let developers manage webhook endpoints that are subscribed to webhook events for real-time updates instead of relying on API polling for faster, more efficient, and a better overall experience. Webhooks are the mechanism Paylias uses to communicate with your system to inform you of time-sensitive payment events, some of which may require action from your end. Webhook endpoints required you to provide a url with the https scheme and optionally a shared secret that will be used to sign the webhook payload before it is sent to your endpoint. When your endpoint is active, Paylias will deliver events through POST with the application/json content type. The endpoint should return a 200 status code back to Paylias as quickly as possible to avoid timeouts. Given the nature of payments on Paylias, webhooks related to payment events are delivered only once. This means that if your system fails to respond with an acknowledgement of receipt through a 200 http status code, an exception will be generated and the payment flow will halt. In this set of guides, we’ll walk through
  1. Webhook implementation
  2. Supported events and event structure
  3. Signature verification