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

# Partner lifecycle webhooks

> Confirm, cancel, and complete payouts for delivered transactions.

# Partner lifecycle webhooks

Buyer systems call Airlead to move transaction state. Auth: buyer webhook secret on every call.

Suggested happy path:

1. Receive `lead.delivered`
2. `POST /api/webhooks/partner-confirmation` with `acknowledged` or `rejected`
3. Optionally `POST /api/webhooks/partner-payout-pending`
4. `POST /api/webhooks/partner-payout` when funds settle

Cancellation: `POST /api/webhooks/partner-cancellation` with a **required** reason.

Supplier-side lead cancellation confirmation uses a separate endpoint and supplier auth: `/api/webhooks/supplier-cancellation-confirmation`.

Airlead validates **allowed status transitions**; timing is owned by the partner.

See API reference:

* [Confirmation](/api-reference/partner-lifecycle/confirmation)
* [Payout pending](/api-reference/partner-lifecycle/payout-pending)
* [Payout](/api-reference/partner-lifecycle/payout)
* [Cancellation](/api-reference/partner-lifecycle/cancellation)
* [Supplier cancellation](/api-reference/partner-lifecycle/supplier-cancellation)