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

# Transaction webhooks

> Webhook events sent for transaction status changes

Safefy sends webhooks to your `callbackUrl` whenever a transaction status changes.

Main events:

* `payment.completed`
* `payment.expired`
* `payment.failed`
* `payment.cancelled`
* `payment.refunded`
* `payment.partially_refunded`

Main headers:

* `X-Safefy-Signature`
* `X-Safefy-Event`
* `X-Safefy-Delivery`
* `X-Safefy-Attempt`

Delivery uses up to 3 retry attempts. Return `2xx` to confirm receipt.