Webhooks
Introduction
Receive real-time updates from SynchPay for events.
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:
- Register your endpoint with SynchPay support.
- Ensure your endpoint is publicly accessible.
- Expect
POST
requests with aContent-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.