ACH Transaction Statuses
ACH transaction status indicates where a transaction is in TabaPay's ACH processing flow. An API status does not represent final settlement because an ACH transaction can be returned after it has been processed.
API Transaction Statuses
Use the Retrieve Transaction API to check an ACH transaction's current status.
| Status | Description | Client action |
|---|---|---|
BATCH | TabaPay has stored the transaction, but it has not reached the applicable ACH processing window. | Wait for ACH processing. Use Retrieve Transaction API to check for a status change. May appear as Batch on the Transactions page in the TabaPay Portal. |
COMPLETE | TabaPay has completed the ACH batch-processing stage. | Do not treat this status as final settlement. Review downstream ACH files and monitor for returns. May appear as Completed on the Transactions page in the TabaPay Portal. |
CANCELLED | ACH Transaction has been canceled by sending a Delete Transaction API with ?void while the status is still in BATCH. | Use Retrieve Transaction API to check for a status change. |
The Retrieve Transaction API currently exposes BATCH, COMPLETE, and CANCELLED for ACH transactions.
File Processing Statuses
Processed and Output Files are primarily used for ACH via Batch File Exchange. These files are not included by default with ACH API integration but may be requested for specific use cases.
| Source | Status | Description |
|---|---|---|
| Processed File | Accepted | Transaction was accepted during TabaPay ACH processing. |
| Processed File | Rejected | Transaction was rejected during TabaPay ACH processing. |
| Output File | Complete | Bank-processing information is available for the transaction. |
| Output File | Error | An error occurred during downstream processing. |
Processed and Output files provide processing information that is not represented by the API status alone.
Note: You can find process file informaiton in the TabaPay Portal Reporting section or Report Builder.
For file formats and delivery information, refer to ACH via Batch File Exchange.
For processing windows, refer to ACH Processing and Cut-Off Times.
Returns
An ACH transaction may be returned after processing, even when the API returns COMPLETE.
Both API-based and file-based ACH clients can review returns in the Exceptions (Daily), or Transactions (Daily) reports. The ACH Return File is also available for Filed-Based ACH, or upon special request.
For return handling, refer to ACH Returns.
Updated 8 days ago
