Transactions
A transaction is an individual entry that represents a financial movement within an account. The Transaction resource represents a confirmed financial transaction that were posted to the account, including its source, amount, and direction.
Transactions cannot be created using Unit's API, they are always the result of other activity, in or out of the platform, that resulted in actual movement of funds. For instance, if you originate an ACH Debit payment, a transaction will be created once the payment has been processed and the clearing period has passed. It is for this reason that transactions do not have statuses.
Transactions are final, and cannot be deleted or changed. In order to reverse a transaction (for example, a refund after a card Purchase transaction), a new, opposite, transaction will have to be created (in our example, a Card Reversal transaction).
Unit provides a cross-platform suite of flexible and customizable white-label UI components, including an activity component that allows the end customer to see their transactional activity on an account or card level. You may embed the activity component into your app to shorten your time to market and deliver a highly optimized experience to your end customer with minimal engineering investment.
Transaction Types
Unit currently supports the following types of transactions:
| Type | Description | |
|---|---|---|
| Originated ACH | An ACH payment originated from a deposit account. | |
| Received ACH | An ACH payment received by a deposit account. | |
| Returned ACH | An ACH payment returned by the bank. | |
| Returned Received ACH | A received ACH payment that has been returned through Unit. | |
| Dishonored Return ACH | A returned ACH that was dishonored by the receiving bank. | |
| Wire | A wire transaction, either received or sent. | |
| Returned Wire | A returned wire transaction. | |
| Book | A payment between two accounts on the same bank. | |
| Purchase | A purchase via debit card. | |
| ATM | A deposit or a withdrawal of funds from an ATM with a debit card. | |
| Fee | Fees incurred for a transaction. | |
| Fee Reversal | A reversal of a previous fee transaction. | |
| Interest | An Interest payment to a deposit account. | |
| Card Reversal | A reversal of a previous card transaction. | |
| Card Transaction | A transaction that represents various card transactions that are not Purchase or ATM transactions. Those might be split in the future into different types. | |
| Release | A transaction releasing funds from a batch account. | |
| Adjustment | Manual Adjustment is made in situations where the correction of an amount, or a reverse of a completed transaction is needed. | |
| Dispute | Dispute transaction is created in order to credit or debit a customer for an ongoing card or ACH dispute. For example, when provisional credit is provided, the customer account would be credited using the Dispute Transaction. | |
| Check Deposit | A received check deposit. | |
| Returned Check Deposit | A check deposit returned by the bank. | |
| Payment Canceled | Cancellation of a previously processed ACH payment. | |
| Payment Advance | Payment advance transaction is created in order to Debit an org account against a ReceivedPayment that is advanced . | |
| Repaid Payment Advance | Repaid payment advance transaction is created when a ReceivedPayment is Completed in order to Credit an org account and repay it for a received payment that was advanced. | |
| Chargeback | A transaction that represent a Chargeback. | |
| Reward | A transaction that represent a Reward. | |
| Account Low Balance Closure | Handling of low balance upon account closure. | |
| Negative Balance Coverage | A transaction that occurs when closing an account with negative balance. covering the account negative balance. | |
| Check Payment | A Debit transaction that occurs when a Check Payment is processed successfully (Processed status). | |
| Returned Check Payment | A Credit transaction that occurs when a Check Payment has been returned through Unit (Returned status). | |
| Push To Card | A Debit transaction that was created from a PushToCard Payment originated from a deposit account. | |
| Push To Card Reversal | A Credit transaction that was created in order to reverse a previous Push To Card transaction. | |
| Cash Deposit | A Credit transaction that occurs when cash is deposited at a Store Location. | |
| Write Off | A Credit transaction that occurs when an uncollectible balance is written off. |
Common Transaction Fields
In addition to their own specific fields, all transaction types are guaranteed to contain the following top-level fields:
New transaction types may be added in the future, as we introduce new financial products. To minimize code changes on your side, we recommend using the summary field when displaying transactions to end-customers.
Transaction Summaries
The transaction summary field is used whenever the transaction details are presented. This applies to monthly statements, data exports (e.g. Plaid, Intuit), and the Unit Dashboard. It is recommended that you use that field when displaying transactions within your UI. The table below describes what how the summary field is generated for each of the transaction types.
| Transaction type | Summary structure | Example | Comments |
|---|---|---|---|
| Originated ACH | <counterparty_name> | <txn_addenda> | Richard Hendrix | ACH PYMT | |
| Received ACH | <txn_company_name> | <txn_description> | Pied Piper INC | Pied Piper | |
| ReturnedACH | Returned due to: <txn.reason> | <txn.counterparty_name> | Returned due to: InsufficientFunds | Richard Hendrix | |
| ReturnedReceivedACH | Returned received ACH transaction #<txn.relatedTransactionId> due to: <tx.reason> | Returned received ACH transaction #1234567 due to: InsufficientFunds | |
| DishonoredACH | Dishonored Return ACH transaction due to: <txn.reason> | Dishonored Return ACH transaction due to: UntimelyReturn | |
| Card Purchase | Purchase from <txn.merchantName> | address: <txn.merchant_address> | <txn.cardLast4Digits> | Purchase from 7-ELEVEN, 7-ELEVEN | Address: ORLANDO, FL, US | **1234 | |
| Return from <txn.merchantName> | address: <txn.merchant_address> | <txn.cardLast4Digits> | Return from 7-ELEVEN, 7-ELEVEN | Address: ORLANDO, FL, US | **1234 | ||
| Card Transaction | <txn.description> | <tx.cardLast4Digits> | Cash App*Cash Out, Visa Direct, CA, US | **1234 | |
| ATM | Withdraw at <txn.atmName> | address: <txn.address> | <txn.cardLast4Digits> | Withdraw at Community Bank, 1983 Beach Blvd | Address: Biloxi, MS, US | **1234 | |
| Deposit at <txn.atmName>| address: <txn.address> | <txn.cardLast4Digits> | Deposit at Community Bank, 1983 Beach Blvd | Address: Biloxi, MS, US | **1234 | ||
| Card Reversal | Reversal for transaction <txn.relatedTransactionId> | <txn.cardLast4Digits> | Reversal for transaction #5146923 | **5380 | |
| Check Deposit | <txn.description> | ||
| Check return | Returned due to: <return reason> | <description> | Returned due to: Unable to Locate Account | Pied Piper | |
| Fee | <txn.description> | Physical Card Replacement Fee | |
| Fee Reversal | Reversal fee transaction for <relatedTransaction.id> | <description> | Reversal fee transaction for #123 | Moves Card Replacement Fee |
| Book | Sender: txn.receiver_name | txn.description | Sender: Richard Hendrix | Peer payment: Henry | |
| Receiver: txn.receiver_name | txn.description | Receiver: Richard Hendrix | Peer payment: Henry | ||
| Batch Release | <txn.description> | <txn.senderName> | Cash Deposit CVS | Richard Hendrix | |
| Interchange | <txn.description> | Accel ATM | |
| Interest | <txn.description> | Interest February 2022 | |
| Wire | Wire from <sender_name> | <description> | Wire from SVB FOR BENEFIT OF Pied Piper | VI FUND I A SERIES OF company ID 12345 | |
| Wire to <beneficiary_name> | <description> | Wire to SVB FOR BENEFIT OF Pied Piper | VI FUND I A SERIES OF company ID 12345 | ||
| ReturnedWire | Returned due to <reason> | <description> | Returned due to: NAMEMISSMATCH | AZ -Part Commission | |
| Dispute | Dispute <dispute_id> | <dispute_reason> | Dispute 3432 | Final Credit | |
| ChargeBack | <txn_description> | ||
| Payment Cancelled | Cancellation of: <txn.id> | Payment Id: <payment.id> | Cancellation of: 381481 | Payment Id: 65647 | |
| Adjustment | <free form summary> | ||
| WriteOff | <txn.description> | Write off for account 10014 |