Recurring Payments

API Reference

Recurring payments allow your customers to make payments on a custom schedule from a single invoice template.

How Recurring Payments Work

Recurring payments are created by creating an invoice template and then updating it to the SCHEDULED status.

Invoice templates create invoices on a custom schedule to pay each recurring payment. To use recurring payments, you will need to:

1. Create an invoice template.

2. Ensure the invoice template has all the necessary information to create recurring invoices:
   • Payment Schedule (set by the paymentSchedule field)
   • First Payment Date (set by the deductionDate field)
   • All other fields required to schedule a normal invoice
3. Update the invoice template to the SCHEDULED status.

Once the invoice template reaches the SCHEDULED status, it will remain there and begin creating recurring invoices according to the template’s paymentSchedule and deductionDate fields.

These invoices will be created in the SCHEDULED state, and will be paid on the scheduled date with no further action required. Once a recurring invoice moves to PENDING on its deductionDate, Mercoa will automatically create the next recurring invoice with the next deductionDate in the SCHEDULED state.

Viewing Recurring Invoices

To view recurring invoices created from an invoice template, filter on invoices with the invoiceTemplateId parameter on the Invoice Search API.

Stopping Recurring Payments

To stop an invoice template from creating more invoices, use the Update Invoice API to update the invoice template to the CANCELED status.