Transaction Statuses and Types

Transaction Statuses

StatusDescription
queuedThe Transaction is being prepared as a result of a Transfer request. Transactions that originate outside of Newline (e.g., debit card transactions, RDFI ACHs, direct deposits, etc.) will not be given this status.
pendingThe Transaction is being processed. This state will persist until all related Transaction Events have settled or could not be completed.
canceledThe Transaction is canceled as a result of the Transfer being canceled. Transfers (and subsequent Transactions) can only be canceled if the aforementioned Transfer is in the queued or pending state. A pending state cancellation is not guaranteed as this state also includes payment execution. At that stage, a cancel request will result in an error.
deniedAn authorization request that was rejected due to a variety of reasons (insufficient_funds, inactive_card, etc.).
failedThe Transaction has failed. This state indicates that one of the related Transaction Events could not be settled. A failed Transaction may require the reversal of a related Synthetic Line Item and/or Custodial Line Item.
settledThe Transaction is complete. All of the related Transaction Events are settled.
expiredDebit card auth has expired.

NoteWhen a Transfer is created through Newline, an associated Transaction is created with queued status. If it involves at least one custodial transfer, once the custodial transfer is initiated, the status will transition to pending. Once a Transaction is settled, whether it has asset movement in custodial level, or is synthetic-only, or is RDFI (no Transfer associated), it will have a settled status.

Transaction Types

TypeDescription
achACH transfer crediting or debiting a Customer's Synthetic Account.
ach_returnA previous ACH Transfer is returned. ACH Return Transactions are new Transaction records, independent of the original ACH Transfer. The original ACH Transfer that relates to the ACH Return can be determined using the Transfer UID populated on the ACH Return.
atm_withdrawalCash is withdrawn at an ATM using a Debit Card.
book_transferA Book Transfer crediting or debiting a Customer's Synthetic Account. Book Transfers can only occur between two general Synthetic Accounts and said accounts are under the same Customer.
card_purchaseA purchase is made using a Debit Card.
card_refundA previous Debit Card Transaction is refunded.
corporate_actionAction by a publicly traded company that affects shareholders (e.g. dividend, stock split, etc.).
creditA credit to the account.
denied_authorizationDenied card authorizations. Here is a list of the Denied Auth reasons.
disputeIf a Customer claims that a Transaction was created in error, one or more Transactions will be created with this type to credit or debit based on the dispute outcome.
feeA fee charged to the account. This includes ACH reversals and Debit Card ATM fees.
instant_paymentAn Instant Payment crediting or debiting a Customer's Synthetic Account.
otherMiscellaneous Transactions, such as write-offs.
prenoteA non-monetary process for testing the accuracy of the information associated with a new transaction, specifically for ach transfers.
reversalNegates all or part of a previous authorization.
set_account_balanceThe transaction used to set a Synthetic Account balance. Only present if the underlying Custodial Account is funded before the Synthetic Account is created.
wireWire transfer crediting or debiting a Customer's Synthetic Account.