Subscriptions are the core recurring billing mechanism supported by Maple.

They map a customer to a group of product pricing plans that are billed at a cadence. Subscriptions can be created both through the API as well as in the Maple web application. Product prices that are attached to subscriptions must have at least one recurring charge. One-time prices can be added on creation as well.

{
    "id": "subs_xyz",
    "company_id": "cmp_xyz",
    "customer_id": "cus_xyz",
    "bundle_pricing_id": "bundle_xyz",
    "start_date": "2023-01-12T05:40:31Z",
    "end_date": null,
    "renewal_date": "2023-04-12T05:40:31Z",
    "term": {
        "frequency": "MONTH",
        "count": 1
    },
    "auto_renews": true,
    "auto_charges": true,
    "metadata": {},
    "change_date": null,
    "change_config": null,
    "cancel_date": null,
    "cancel_config": null,
    "pause_date": null,
    "pause_config": null,
    "next_invoice_date": "2023-04-12T05:40:31Z",
    "mrr": {
        "value_in_cents": 3995,
        "currency": "USD"
    },
    "arr": {
        "value_in_cents": 47940,
        "currency": "USD"
    }
}

There are other key actions that can be performed on subscriptions that your application might want to support such as

​
Changing subscriptions

Customers typically go through subscription lifecycles of either upgrades or downgrades or simple changes. Changes to plans can be done immediately or scheduled for a future date. They can also be prorated immediately or on the next invoice. You can also reset the billing anchor which implies that going forward the subscription cadence is set from the change date.

​
Pausing subscriptions

Payments for subscriptions can be paused with invoicing in draft or void mode. The subscription lifecycle continues as usual (for example, future subscription cancellation).

​
Cancelling subscriptions

Plans can be cancelled with the options to end immediately, at the end of the billing period, at renewal or at a custom date. Cancellations can be issued with refunds (last payment or prorated).

​
Trial subscriptions

Subscriptions can be set up in trial mode enable your users to try your product before they purchase it. Maple allows you to automatically enroll your customers into a plan with or without a credit card at the end of the trial and track trial conversion metrics to understand the funnel better.