Overview

When integrating with PaySway, you often need your applications to respond automatically whenever important events occur. This is where webhooks come into play. Instead of constantly polling for updates, you can rely on PaySway to send notifications to your systems in real time whenever new activity happens.

How webhooks work

A webhook is a secure HTTPS endpoint that you host within your backend. When events occur in PaySway, we send HTTPS requests containing JSON payloads to your registered endpoints. Each payload includes information about what happened and when.

Real-time notifications

Receive instant updates when events occur, enabling immediate response and processing.

Reliable delivery

Built-in retry logic with exponential backoff ensures events reach your systems even during temporary outages.

Secure verification

Cryptographic signatures ensure only authentic requests from PaySway reach your endpoints.

Event filtering

Subscribe only to the events you need, reducing noise and processing overhead.

Implementation steps

Follow our step-by-step guide to implement webhooks in your application:

1. Build your webhook handler

   Implement handler

   Create a secure HTTPS endpoint that can receive and process PaySway event notifications. Learn about requirements, retry logic, and proper response handling.

2. Configure webhook subscription

   Subscribe to events

   Configure your webhook subscription through the PaySway API to start receiving events. Set up subscriptions, manage event filters, and obtain security credentials.

3. Verify request authenticity

   Verify requests

   Implement signature verification to ensure requests are genuinely from PaySway. Secure your webhook with cryptographic signature verification.

4. Handle events

   Event types

   Complete reference documentation for all webhook event types and their data structures.