Batch Payments
Batch payments allow your customers to pay multiple invoices in a single transaction.
Batch payments are currently only available for bankAccount
and check
payments. custom
payments are not officially supported, but you can implement them yourself.
Enabling Batch Payments
To enable batch payments, you will set batchPayment
on the invoice to true
. This field will be true
if the invoice is a batch payment, and false
otherwise.
The Mercoa <PayableDetails />
react component also supports batch payments using the <PaymentOptions />
sub-component.
How Batch Payments Work
Mercoa will automatically batch payments for invoices that have the batchPayment
field set to true
. This means that you will not need to manually batch payments.
Mercoa uses the following logic to determine if an invoice is part of a batch:
- If the invoice has the
batchPayment
field set totrue
- The invoice has the same
payerId
andvendorId
- The invoice has the same
paymentSourceId
andpaymentDestinationId
- The invoice has the same
paymentDestinationOptions
- The invoice has the same
deductionDate
If any of these conditions are not met, the invoice will be considered a separate payment.
Bank Payments
Mercoa will send a single ACH payment for all invoices in a batch. The paymentDestinationOptions
memo
assumes that all the invoices in the batch contain the same memo, as one is chosen at random.
Check Payments
Mercoa will send a single check payment for all invoices in a batch. The check memo will contain the invoice numbers of all the invoices in the batch joined by a comma.