Subscriptions
Gain a better understanding of Digital River's subscription service along with how to define a business model and set up free trials
Last updated
Gain a better understanding of Digital River's subscription service along with how to define a business model and set up free trials
Last updated
Digital River offers a -compliant subscription management service that automatically schedules and processes recurring payments. The service allows you to offer customers free trials and numerous ways to fund recurring transactions.
On this page, you'll find information on:
How you do subscription acquisitions depends on the checkout solution(s) you've selected. Use the following table to access the appropriate article:
Once you create the acquisition containing the subscription, you must activate the subscription, fulfill the goods, and manage renewals. For details on how to handle these and other processes, refer to the page.
You can share among in the subscription service. We recommend not relying on to model subscription entitlements. We also suggest using different plans for your offerings since you can use them to model cohorts for reporting purposes.
Digital River's subscription service models recurring billing. It's not intended to model subscription access or entitlements. As a result, you cannot call the service to determine a customer's current access level.
Subscription metadata and client data linked to the subscription are useful for modeling details irrelevant to Digital River and within the plan's terms.
With Digital River's subscription service, you can either use or to define the of any you intend to offer on a subscription basis.
For more details, refer to and .
The following diagram shows how plans define the behavior of subscriptions that belong to them.
If you attempt to create subscriptions that belong to discontinued
or deactivated
plans, an error is thrown during the acquisition checkout.
The plan's interval
and intervalCount
determine the trial period's length. If, for example, you want to offer a 31-day free trial period, set interval
to day
and intervalCount
to 31
.
When setting up a payment in acquisitions or modifying a subscription's payment source, customers must select the payment methods they want to use for recurring transactions.
To learn more about how you interact with subscriptions during checkouts, use the following table to access the appropriate article:
Once you've , you should set up that define the behavior of your subscriptions.
At a minimum, you should specify a plan's and terms, designate its , set up , and configure its and .
When you create a plan using the request, you can set state
to draft
or active
. If you're using Digital River as the system of record before deployment, you may decide creating draft
plans is beneficial. We will generate one for you if you don't specify a unique id
in the create plan request.
A 201 Created
response contains a unique plan identifier. The request also triggers an with a of plan.created
. If the state
is draft
when you're ready to launch, send its identifier as a path parameter in a and use the request's body to set state
to active
.
The plan must be active
before you can add to it. For details, refer to the and .
When managing plans within the Digital River system, it's important to understand the implications of discontinuing and deactivating them. Discontinuing a plan allows subscription renewals to continue, but you cannot add new ones. In contrast, deactivating a plan terminates all associated active subscriptions on their . This section will guide you through adjusting a plan's state and highlight the differences between these two actions.
When you want to discontinue or deactivate a plan, specify the desired state
in the payload of a request.
Refer to the and for details on how discontinuing or deactivating a plan affects its associated subscriptions.
You can configure a customer's subscription to include a free trial period. This section provides information on before deployment. How you handle subscription acquisitions that involve free trials depends on the checkout solution(s) you've selected. Use the following table to access the relevant content:
in
in
Once you create the acquisition containing the subscription, you must convert it from trial to paid. For details, refer to .
Before offering free trials, you must configure and deploy plans for your trial .
Refer to for general information on plans and their relationship to subscriptions.
For each subscription you intend to offer on a trial basis, you should define a and . The following diagram shows how you might set up two plans that result in a seven-day free trial period followed by a monthly, recurring billing cycle:
Your trial period controls the behavior during its first billing cycle.
For free trial plans, set billingOffsetDays
to 0
. This configuration results in a subscription whose initial billing cycle has the same and , thereby ensuring that the first payment capture attempt occurs after the trial period ends.
The value you give reminderOffsetDays
determines when the event is created. For example, a reminderOffsetDays
of 3
results in creating a subscription.reminder
event three days before the trial period's conclusion.
Use collectionPeriodDays
to define the number of days when Digital River will attempt to capture payment. Once the trial period ends, Digital River will initially attempt to charge the customer's designated . If this proves unsuccessful, our will continue making capture attempts for the number of days you specify.
You must also define a paid period that governs the after its trial conversion. The following plan bills customers monthly, and in every billing cycle, Digital River makes the first payment capture attempt three days before the end period date.
Refer to the page for a complete list of such payment methods.
In acquisition checkouts, you can combine a primary source with one or more secondary sources. Refer to the page for details on .