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: 1
and 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.
Updated 25 days ago