Overview

Webhooks allow your backend to receive real-time updates from SynchPay. Whenever important events occur—such as a change in a payment request’s status—SynchPay sends an HTTP POST request to a webhook URL you provide.

By subscribing to these webhooks, you can keep your application synchronized without needing to poll the API.

Setting Up Webhooks

To receive webhook notifications:

  1. Register your endpoint with SynchPay support.
  2. Ensure your endpoint is publicly accessible.
  3. Expect POST requests with a Content-Type: application/json.

Handling Webhooks

Make sure your server:

  • Returns a 200 OK status code to acknowledge receipt.
  • Logs and processes the payload securely.
  • Retries or alerts in case of failure.