Transaction Statuses
This document provides detailed descriptions of the transaction statuses available in the VCI API. Each status indicates a specific stage in the lifecycle of a transaction processed through our ACH payment system. Understanding these statuses will help merchants and developers effectively integrate and manage their financial operations using our API.
Status Definitions
Accepted
The transaction has been created by the Merchant on the VCI system and is queued to be submitted to the Federal Reserve. Transactions in this status are scheduled for the next cutoff, generally at 6:00 PM ET.
Useful Attributes:
created_at- Timestamp when the transaction was created.
Originated
The transaction has been submitted to the Federal Reserve to debit the source bank account. At this stage, the transaction is considered "in-flight" and cannot be voided. The source bank account will see a debit transaction on their bank statement the following business day.
Useful Attributes:
originated_at: Timestamp when the transaction was originated.
Settled
The transaction has completed and a credit has been issued to the recipient's bank account. The recipient will see a credit entry on their bank statement on the following business day.
Useful Attributes:
settled_at: Timestamp when the transaction was settled.
Return
The transaction was rejected by the recipient's bank for various reasons such as Insufficient Funds, Bank Account Not Found, Account Closed, Unauthorized Debit, or Customer revoked Authorization.
Useful Attributes:
returned_at: Timestamp when the transaction was returned.return_reason: Description of the reason for the transaction return.return_code: Three character code of the reason for the transaction return. Examples: R01, R02, R03.
Error
The transaction was immediately rejected at the time of request by the VCI system due to issues such as insufficient or incorrect data, exceeded merchant velocities, or known problematic customer bank accounts.
Useful Attributes:
errored_at: Timestamp when the transaction marked as Errored.
Void
The transaction was canceled by the Merchant. This can only occur if the transaction is still in the Accepted status and has not yet been Originated. Merchants have until the cutoff to cancel any transactions that are still in the Accepted status.
Useful Attributes:
voided_at: Timestamp when the transaction was canceled.
Updated 6 months ago