Check Deposit Events
The following webhook events are triggered during the check deposit lifecycle. Subscribe to these events to track the status of check deposits in real-time.
Check Deposit Events
| Event | Description |
|---|---|
| checkDeposit.created | Fired when a check deposit is created. |
| checkDeposit.pending | Fired when a check deposit moves to Pending status after images are uploaded and validated. |
| checkDeposit.pendingReview | Fired when a check deposit requires manual review by Unit. |
| checkDeposit.clearing | Fired when a check deposit enters the clearing period. The funds have been received but not yet credited to the account. |
| checkDeposit.sent | Fired when a check deposit is successfully processed and the deposit account is credited. This is the final state for successful check deposits. |
| checkDeposit.rejected | Fired when a check deposit is rejected. See Reject Reasons for more details. |
| checkDeposit.returned | Fired when a check deposit is returned by the receiving bank. See Return Reasons for more details. |
Related Transaction Events
| Event | Description |
|---|---|
| transaction.created | Fired when the credit transaction is created for the check deposit. This occurs when the check deposit moves to Sent status. |
Event Flow
A typical successful check deposit follows this event sequence:
checkDeposit.created- Check deposit is createdcheckDeposit.pending- Images uploaded and validated (orcheckDeposit.pendingReviewif manual review is required)checkDeposit.clearing- Funds received, clearing period beginscheckDeposit.sent- Clearing period ends, account creditedtransaction.created- Credit transaction recorded
For more information on webhooks and event handling, see the Webhooks documentation.