Payment Webhooks

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 NameDescription
ProcessedThe payment was successfully received and deposited.
ProcessingThe transaction is in progress and funds are pending deposit. Timing may vary based on account settings.
PendingThe transaction was created and is currently in the processing queue.
VoidedThe transaction was canceled before completion.
UnpaidThe transaction has not yet been authorized by the customer. No funds have been moved.
HoldThe transaction is awaiting manual review. It will only continue if approved in your Paynote dashboard.
DeclinedThe 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)
FailedThe transaction failed. Review the return code in the ACH Return Code Reference.
ExpiredThe transaction expired and can no longer be processed.
Refund PendingA refund has been initiated and is currently being processed.
RefundedThe refund was successfully completed.
Refund FailedThe refund attempt failed. You may need to retry manually.
PrintedThe 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"
}