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.

What are Invoice 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.
For API reference documentation and endpoints, see Invoice Account Number API Reference.

Key Benefits

  1. Simplified Payment Tracking: Use different account numbers to track payments from various sources without managing multiple accounts
  2. Invoice Based Collections: Assign unique account numbers to specific invoices for easy reconciliation
  3. No Payment Limits: There are no restrictions on payment size or frequency except those set by the underlying account.
  4. Unified Account Management: All funds arrive in a single account, simplifying balance management and reporting

How Invoice Numbers Work

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.
Invoice Account Numbers Flow

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

Important Considerations

  1. Not Separate Accounts: Invoice account numbers are routing aliases, not independent accounts.
  2. Bank Enablement Required: Your bank must have the invoice_account_allowed flag enabled.
  3. No Payment Limits: There are no restrictions on payment size or frequency other than what the underlying account has setup.
  4. Permanent Availability: Invoice account numbers can remain active indefinitely.
  5. Dashboard Visibility: Invoice account numbers appear in the “Additional Account Numbers” section of the account detail page.
  6. 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.
  7. Account Format: The new account numbers will be formatted exactly as existing account numbers. They will look just like a normal account number.
  8. Ledger Only: Invoice account number only work when using the Treasury Prime ledger. The core direct product is not supported.
  9. 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