Modern Treasury provides multiple methods of payments. Choosing one of these methods will connect the payment to the lifecycle of the invoice and automatically update the status of the invoice based on the status of the payment.
Invoices can be sent with embedded payment flows, this is a component on the invoice where the end recipient can enter the details of the account from which they want to be debited. Once the recipient hits submit a payment order is created to ACH debit their account. The originating account must have ACH debit capabilities enabled to use this payment method.
To send an invoice with an embedded component, either:
- Enable payment collection on the create invoice page
- Create an invoice with
The recipient will receive an invoice looking like the following:
Invoices can be sent with automatic payments enabled, in this case a payment order object is created at the time the invoice is issued. Today we support ACH Debits via this method and the debit will be initiated on the Payment Effective Date. The originating account must have ACH debit capabilities enabled to use this payment method.
To send an invoice with a automatic payment either:
- Enable automatic payment on the invoice creation page
- Create an invoice with
automaticand fill in the appropriate values for the parameters
payment_type. More information can be found on the invoice API reference.
After an invoice has transitioned from
draft to the
unpaid state, a payment can be manually issued via the UI or the API. The payment order issued must have matching
currency to the invoice and must be in the direction of a
By default, an invoice will create a corresponding expected payment object when created. The expected payment will be set with attributes designed to match a payment for the invoice amount from the counterparty. It is recommended that the recipient puts the invoice number e.g.
2023-00004 on the statement description in their payment to improve the likelihood of matching the payment with the invoice. More details about the statement description can be found here. Once the expected payment has been matched with the corresponding transaction line item, those items will be associated with the invoice.
The invoice lifecycle will be directly connected to the payment object it is associated with. When the payment order or expected payment successfully completes, the invoice will be marked as
paid. When a payment order is created, the invoice will be marked as
Invoices can be manually marked as
paid through the UI or the API as long as the invoice is not in the
When an invoice is transitioned to
payment_pending through embedded payment UI or
paid manually, any associated expected payment object will automatically be archived to avoid duplicated payments.
To use invoice payments, you will need the following permissions:
- Ability to create invoices in your organization
- Ability to read the invoice counterparty
To create an invoice with automatic payment enabled, you will need the above permissions in addition to:
- Ability to read the receiving account
- Ability to create a new payment order
To create an invoice with an associated virtual account, you will need the above permissions in addition to:
- Ability to read the virtual account
Updated 7 days ago