Payment Methods

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.

Embedded Payment UI

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

Or:

• Create an invoice with payment_method set to ui.

The recipient will receive an invoice looking like the following:

Automatic Payment

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

Or:

• Create an invoice with payment_method set to automatic and fill in the appropriate values for the parameters payment_effective_date, receiving_account_id, and payment_type. More information can be found on the invoice API reference.

Manually Issuing Payment

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 originating_account_id, amount, currency to the invoice and must be in the direction of a debit.

Payments from outside Modern Treasury

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.

Invoice Status

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 payment_pending.

Invoices can be manually marked as paid through the UI or the API as long as the invoice is not in the payment_pending state.

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.

Required permissions

To use invoice payments, you will need the following permissions:

1. Ability to create invoices in your organization
2. Ability to read the invoice counterparty

To create an invoice with automatic payment enabled, you will need the above permissions in addition to:

1. Ability to read the receiving account
2. 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:

1. Ability to read the virtual account