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
• Payout pending
• Payout
• Cancellation
• Supplier cancellation