---
title: Webhooks
description: Receive real-time notifications when payments succeed or fail.
---

:::note
This is dummy placeholder content for scaffolding purposes.
:::

Apipay sends webhook events to a URL you configure whenever a payment's status changes.

## Verifying signatures

Every webhook request carries an `X-Apipay-Signature` header. Verify it before trusting the payload.

## Events

- `payment.succeeded`
- `payment.failed`

See the [API reference](/api) for the full payload shape.