Checks can only be updated to one of two statuses via the API:
canceled
stop_payment_pending
Cancel A Check
After a check is first created, there is a 1-hour cancellation window in which a check can be moved to the canceled
status. Once this is done, the funds will be returned to the originating account. After the 1-hour window closes, a check can no longer be canceled.
Request Stop Payment
After 1 hour from when a check is first created it will be moved to the sent
status. Once a check moves out of pending
and into sent
, a user is no longer able to cancel a check. However, a stop_payment
request can be made to the bank requesting that they prevent the check from being paid out.
A successful request will move the check to stop_payment_pending
and will remain in that state until reviewed by the bank or moved to expired
after 180 days from when the check was first created.