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

# Webhooks

> Receive Merchant API callback updates.

Callbacks help your system track payment and transfer progress.

## Callback URL

For collection and transfer requests, send a `callback_url` in the request body. Sarafa sends status updates to that URL.

Your endpoint should:

* Accept `POST` requests.
* Respond quickly with a success status.
* Store the event and transaction reference.
* Handle duplicate events safely.

## Collection pending event

Sent after a collection is created.

```json theme={null}
{
  "event": "collection.pending",
  "status": "pending",
  "data": {
    "product": "collect_mobile",
    "status": "pending",
    "external_reference": "order-1001"
  }
}
```

## Transfer pending event

Sent after a transfer is created.

```json theme={null}
{
  "event": "transfer.pending",
  "status": "pending",
  "data": {
    "product": "disburse_mobile",
    "status": "pending",
    "external_reference": "payout-1001"
  }
}
```

Use the transaction endpoints to fetch the latest status when your system needs to reconcile activity.