Retrieve subscription change timeline

Use the fetchChangeSubscriptionOptions function to control when a subscription change made in the Self-Serve Portal takes effect: either immediately or at the end of the current term. Chargebee invokes this function when a customer changes their subscription and uses the value you return to schedule the change.

This function is one of the two functions supported by Portal Custom Code.

Usage and invocation

Write your business logic to classify each subscription change, and return end_of_term to tell Chargebee when to apply it:

• Set end_of_term to false to apply the change immediately.
• Set end_of_term to true to apply the change at the end of the term.

Requirements

• Write the function in JavaScript.
• Make sure the function runs in a Node.js v6.0 environment.
• Use the resources that Chargebee passes to the function to write your business logic. These resources use the same format as the output of the Node.js client library.
• To retrieve additional resources, use Chargebee's Node.js client library, provided you've already configured it with your API key and secret key.
• Return a JavaScript object that matches the JSON schema on this page.

Parameters

Example

This function treats a change as a downgrade when the customer reduces the quantity of the current plan or moves to a lower-priced plan, and defers those downgrades to the end of the term. All other changes apply immediately.

var chargebee = require("chargebee")

exports.fetchChangeSubscriptionOptions = function ({ subscription, subscription_changes }, callback, logger) {

    chargebee.plan.retrieve(subscription_changes.plan_id).request((error, result) => {
        if (error) {
            callback(error, null);
            return;
        }

        let downgrade = false;
        // On multi-decimal sites, the quantity is in the *_in_decimal fields; fall back to the integer fields otherwise.
        let changedPlanQuantity = Number(subscription_changes.plan_quantity_in_decimal || subscription_changes.plan_quantity);
        let currentPlanQuantity = Number(subscription.plan_quantity_in_decimal || subscription.plan_quantity);
        let changedPlanUnitPrice = result.plan.price;

        // Same plan, quantity reduced.
        if (subscription.plan_id == subscription_changes.plan_id && changedPlanQuantity < currentPlanQuantity) {
            downgrade = true;
        }
        // Different plan at a lower price.
        if (subscription.plan_id != subscription_changes.plan_id && subscription.plan_unit_price > changedPlanUnitPrice) {
            downgrade = true;
        }

        callback(null, { end_of_term: downgrade })
    });
}

{
  "end_of_term": true
}

Expected JSON schema for the output

The return value must match the following JSON schema.

{
  "type":"object",
  "$schema":"http://json-schema.org/draft-04/schema#",
  "definitions":{},
  "properties":{
    "end_of_term":{
      "type":"boolean",
      "default": false,
      "examples":[
         true
       ]
      }
    },
    "additionalProperties": false
}