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 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"
}