Subscription products & renewal payments

Subscription products are defined by having a frequencyCount of greater than 0. You must set a frequency to HOUR, DAY, WEEK, MONTH, or YEAR.

It is recommended that you set autoinvoice:true for all Loop products. This directs Loop to automatically generate the next due payment.

How Loop subscription products behave with auto-nvoicing

When autoInvoice: true the frequency is used to calculate the next invoice date.

Example: For subscription set to frequencyCount: 1and frequency:MONTH, if a customer completes checkout on November 29th. The auto-invoicing will generate the next invoice on December 29th.

If the customer checked out on the 31st and there is no 31st, then the invoice will generate on the last day of the month (e.g. 30th or 28th for February.

Turning on auto-invoicing after product creation and with existing customers

If you set autoInvoice: true for a product that already has active customers, the first autogenerated invoice will use the billDate of the last pending or successful invoice.

Example: Last successful created invoice for the item, which has a frequencyCount: 1 and frequency:HOUR was at 8am, you enable auto invoicing 12pm for that item. The next invoice generated for that agreement will have a billDate of 9am.

If this is not desired, the workaround is to manually create an invoice for now (12pm) using the POST Transfers endpoint, and only then enable auto invoice. The next invoice will be generated from that just created manual invoice and be set to 1pm.

Changing parameters for subscription product with auto-invocing

If you change the amount or the frequency of an item that is set to auto-invoicing, the next invoice generated for any existing subscriptions will reflect the new amount/frequency.