Overview
Webhooks
Section titled “Webhooks”CowriePay sends a signed HTTP POST to your registered endpoints when a tracked event occurs.
The signature recipe with ready-to-paste samples, the deduplication contract, the retry
schedule, secret rotation and the delivery log live in the Webhooks guide on the
documentation site, in English and French. The event catalogue stays here, next to the
events field that accepts these values.
Event types
| Event | When it fires |
|---|---|
DEPOSIT_DETECTED |
Transaction seen on-chain (unconfirmed) |
DEPOSIT_CONFIRMED |
Minimum confirmations reached, safe to credit |
DEPOSIT_SWEPT |
Funds moved to CowriePay master wallet |
DEPOSIT_FLAGGED |
Deposit flagged for AML review, do not credit |
DEPOSIT_REJECTED |
Deposit refused after review. It will never be credited. Reason-free by design: the payload carries no screening detail |
WITHDRAWAL_PROCESSING |
Withdrawal broadcast to the network |
WITHDRAWAL_CONFIRMED |
Withdrawal confirmed on-chain |
WITHDRAWAL_FAILED |
Withdrawal failed, funds returned to balance |
WITHDRAWAL_CANCELLED |
Withdrawal cancelled before broadcast |
WITHDRAWAL_HELD |
Withdrawal held for AML review, destination flagged |
WITHDRAWAL_PENDING_APPROVAL |
Withdrawal above the approval threshold, awaiting member approval (four-eyes) |
BENEFICIARY_ADDED |
A withdrawal allowlist beneficiary was added (security alert) |
BENEFICIARY_REMOVED |
A withdrawal allowlist beneficiary was removed |
WITHDRAWAL_POLICY_CHANGED |
Withdrawal security config changed (allowlist / cooling-off / approval / limits); data.weakened flags a change that reduced a protection |
COMMITMENT_ADJUSTMENT_EMITTED |
A monthly minimum commitment catch-up was emitted for a closed month: period, floor, billed fees, the difference, the recovery mode, what was debited and what stays outstanding |