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 |
|---|---|
Processed | The payment was successfully received and deposited. |
Processing | The transaction is in progress and funds are pending deposit. Timing may vary based on account settings. |
Pending | The transaction was created and is currently in the processing queue. |
Voided | The transaction was canceled before completion. |
Unpaid | The transaction has not yet been authorized by the customer. No funds have been moved. |
Hold | The transaction is awaiting manual review. It will only continue if approved in your Paynote dashboard. |
Declined | The transaction was blocked due to one of the following: – Insufficient funds – Unable to retrieve balance – High bank risk (Plaid Signal) – High customer risk (Plaid Signal) |
Failed | The transaction failed. Review the return code in the ACH Return Code Reference. |
Expired | The transaction expired and can no longer be processed. |
Refund Pending | A refund has been initiated and is currently being processed. |
Refunded | The refund was successfully completed. |
Refund Failed | The refund attempt failed. You may need to retry manually. |
Printed | 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"
}