Use multiple account numbers to receive payments into a single ledger account
Invoice Account Numbers enable you to allocate additional account
numbers to an existing ledger account, allowing you to receive
payments through multiple account numbers while maintaining a single
destination for funds. This feature is particularly useful for
businesses that need to track payments from different sources or
associate specific account numbers with different invoices,
departments, or partners.These can also be thought of as virtual account numbers.
Invoice Account Numbers are additional routing endpoints for an
existing ledger account. They are not separate accounts but rather
alternative account numbers that all route payments to the same
underlying ledger account. When payments are sent to any of these
invoice account numbers, they are automatically posted to the
associated bank account and include the invoice account number for
easy tracking.
Incoming ACHs and wires received for the invoice account number will
be posted to the associated ledger account. These payments will be
posted to the ledger account just as if they were a payment to the
account number on the ledger account.The account number for the ACH/wire will continue to be surfaced on
the /incoming_ach and
/incoming_wire endpoints which will
allow customers to make the connection to the invoice account number.
Transaction descriptions behave the same regardless of whether an
incoming payment posts to the primary account number or an invoice
account number.
Additional Key Points about Invoice Account Numbers
Dashboard Display: Additional account numbers appear in an
“Additional Account Numbers” field on the account detail page
Payment Types: Supports both incoming ACHs (debit/credit) and
incoming wires
Transaction Appearance: Transactions appear like normal payments,
with the account number matching the invoice account number in
incoming ACH/wire objects
Account Nature: These are not separate accounts, but rather
additional account numbers linked to an existing ledger account
Bank Controls: Banks can only control whether organizations can
create invoice accounts using the invoice_account_allowed flag.
There are no limits on payment size or number of account numbers
Lifecycle: Can remain active indefinitely and can be
disabled/re-enabled as needed
Not Separate Accounts: Invoice account numbers are routing
aliases, not independent accounts.
Bank Enablement Required: Your bank must have the
invoice_account_allowed flag enabled.
No Payment Limits: There are no restrictions on payment size or
frequency other than what the underlying account has setup.
Permanent Availability: Invoice account numbers can remain
active indefinitely.
Dashboard Visibility: Invoice account numbers appear in the
“Additional Account Numbers” section of the account detail page.
Receive Only Account Numbers: These numbers are only available
for inbound transfers. They can accept ACH, wires, or other
payments initiated externally. You cannot originate payments from
these account numbers.
Account Format: The new account numbers will be formatted
exactly as existing account numbers. They will look just like a
normal account number.
Ledger Only: Invoice account number only work when using the
Treasury Prime ledger. The core direct product is not supported.
KYC: No KYC will not be run on these account numbers. This
feature will assign an additional number to an existing account,
not a new type of account that is opened