Paynote sends webhook events when a transaction status changes. Use these events to track transaction progress, handle failures, or trigger refunds and customer updates in real time.
Event Types
Event Name | Description |
|---|---|
| The payment was successfully received and deposited. |
| The transaction is in progress and funds are pending deposit. Timing may vary based on account settings. |
| The transaction was created and is currently in the processing queue. |
| The transaction was canceled before completion. |
| The transaction has not yet been authorized by the customer. No funds have been moved. |
| The transaction is awaiting manual review. It will only continue if approved in your Paynote dashboard. |
| The transaction was blocked due to one of the following: |
| The transaction failed. Review the return code in the ACH Return Code Reference. |
| The transaction expired and can no longer be processed. |
| A refund has been initiated and is currently being processed. |
| The refund was successfully completed. |
| The refund attempt failed. You may need to retry manually. |
| The check was printed by the customer. |
Example Payload
{
"event": "transaction.status",
"check": {
"status": "processed",
"check_id": "88e5cf90-473b-11e9-88ab-8fb3cc1aab01"
},
"timestamp": "2019-03-25T12:08:08Z"
}