Repayment Events
Unit raises events related to repayments that you can subscribe to via webhooks. These events allow you to track the lifecycle of repayments and respond to status changes in real-time.
Available Events
| Event | Description |
|---|---|
| repayment.created | Raised when a new repayment is created. |
| repayment.statusChanged | Raised when the status of a repayment changes (e.g., from Pending to Clearing, Sent, Returned, etc.). |
Event Payloads
repayment.created
This event is raised when a repayment is successfully created. For native repayments (Book or ACH), a subsequent payment.created event will also be raised for the underlying payment.
Related resource types:
repayment.statusChanged
This event is raised when the status of a repayment changes. Common status transitions include:
Pending→Clearing(ACH repayment transmitted to the network)Clearing→Sent(ACH repayment cleared)Sent→Returned(Repayment returned)Pending→Rejected(Repayment rejected)Pending→Canceled(ACH payment canceled)
Related resource types:
Related Events
When working with repayments, you may also want to subscribe to these related events:
| Event | Description |
|---|---|
| payment.created | Raised when the underlying payment for a native repayment is created. |
| payment.clearing | Raised when an ACH payment enters the clearing period. |
| payment.sent | Raised when the underlying payment is sent/completed. |
| payment.returned | Raised when the underlying ACH payment is returned. |
| transaction.created | Raised when a transaction is created as a result of the repayment. |
| recurringRepayment.skipped | Raised when a recurring repayment is skipped (e.g., due to zero balance). |
For more details on all available events and their payloads, see the Events API reference.