...
| Table of Contents | ||
|---|---|---|
|
...
| Info |
|---|
Note that with multi-tenants, different instances of the platform may have different invoicing dates configured |
...
Recurring bills
The application provider can also chose to bill its customers on a regular basis. By creating a Recurring bill on Maestrano, a new bill is going to be automatically generated every month, and the corresponding customer is going to be charged on the 25th.
A Recurring bill is created for a predefined period of time (eg: a given number of months).
Recurring bills can have several statuses:
- When the Recurring bill is created, its status will be set at Submitted
- Once it has generated a first bill, the Recurring bill will then be at status Active
- The Recurring bill can then be deleted (cancelled) by the app provider, its status will thus be at Cancelled
- When the Recurring bill has reached its last specified cycle (eg: 12 months + 1 day for a 12 months recurring bill), its status will be at Expired
FAQ:
Is the application provider notified when the status of a recurring bill changes?
> No, because the status changes are in the control of the app provider anyway (cancellation, expiration...). However, the app provider can query Recurring bills at any time if needed.
What happens to the Recurring bills when a customer unsubscribes? Does the application provider need to do anything special with the bills?
> Nothing special is expected from the application provider: Maestrano just won't charge the customer any more.
Upon creation of a Recurring bill, a bill has automatically been created, that has been activated the 25th of the month. When is the following bill going to be created/activated?
> Recurring bills have an anniversary date which is the "StartDate" (ie: date at which the recurring bill has been created). Bills will be generated every month at the same day (eg: 9th March, April, May... if the recurring bill has been generated the 9th of February).
I've cancelled a recurring bill, but it did not cancel any of the "child" bills that have been generated. Is that normal?
> Yes, upon cancellation of a recurring bill, the bills that have already been issued won't be cancelled, it is just that the recurring bill won't generate new "child" bills. If a "child" bill is still in submitted status, it can also been cancelled separately. Any bill at in invoiced status can no longer be cancelled.
Find out more...
Need for more in-depth information on single-billing? Please visit the SDK-free Integration section in this wiki.