> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.synchpay.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

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.