The possibility of handling Subscriptions within the Buckaroo environment started a few years after the introduction of Credit Management. With Subscriptions the periodic invoicing can be outsourced completely to Buckaroo, including a chosen reminder scheme for the invoice. Buckaroo will take care of the bill run and the invoice timing. Mutation messages are only needed in case anything changes to the subscription. E.g.: upsell or downsell or debtor changes. Here are some definitions to be taken into consideration:
There are 3 types of messages to manage a subscription. If you want to know how to use these messages properly, please consult the drawing which shows how the Buckaroo features are interconnected.
The parameters of the products, like price or number of units, on an active subscription can be changed. It is also possible to add products to an active subscription, or stop the priceplan of a product. The update subscription call on the development page can be used to make these changes.
Each bill run performed via the Subscription module directly triggers the Credit Management module. Subsequently, the Merchant will receive an invoice push with regard to this activity. Once the Merchant has received the invoice push, the invoice can be incorporated in the debtor administration of the Merchant. After each mutation, the Merchant will receive a push message regarding the invoice payment or the payment reminder status. Thus, Merchants have a complete overview of the debtors’ status without actively having to retrieve this status from Buckaroo themselves. All Credit Management features are managed by the Subscription module. If the Merchants want to change the way in which this is done, they can send a mutation message for each individual subscription.
Questions to be considered when choosing between Credit Management or the Subscription Engine:
Question 1: Who executes the bill run?
If you as a Merchant have a complete invoicing system at your disposal, including invoices and their details, we advise you to use our Credit Management. Invoices can be presented to Buckaroo by way of a separate call or by batch, and will be collected using the preferred payment method. This includes a reminder scheme. It is also possible to similarly use notifications (PayperEmail) to collect the invoices.
Question 2: Is the invoice amount always the same?
When the invoice amount is always the same, why not use our Subscription service? The bill run will be outsourced to Buckaroo based on the products registered on the subscription. A bill run can be performed with any desired repeat period and at any given time within that period. It is up to the Merchant to decide whether all invoices have to be generated at the same time or whether they have to be created gradually over time.
Question 3: How many mutations are there per subscriber during each invoice period?
Each product and/or price mutation has to be communicated to the Subscription Engine. Depending on the number of mutation messages, you as a Merchant can decide whether you want to keep on executing the bill run yourself or not. If, for example, 50,000 invoices are created per month and there’s a maximum of 2,000 mutations, then using our Subscription Engine has its advantages.
The Merchant can start the subscription using the Buckaroo subscription engine, using the information which belongs to the related product. The blocks below, marked with *, are optional. The summary of the possible steps is as follows:
You can start a subscription by using the "create combined subscription" message. The first step consists of the realtime use of an initial payment method that can be used recurrently from then on. You can start a subscription by using a: