Skip to main content

Setting up subscriptions

The Subscriptions section in the left menu lists all subscriptions created in the project. Use it to create subscriptions, edit existing ones, and delete those you no longer need.

Subscription list​

The module opens with a table of all subscriptions in the project. For each subscription, the list shows:

  • Name of the subscription.
  • Payment Account linked to the subscription.
  • Period: how often payment is due, in days.
  • Cost: the sum of the prices of the products in the subscription.
  • Actions: edit and delete.

Creating a subscription​

To create a subscription, click "Create" above the list and fill out the form:

  • Name: the subscription name shown in the list.
  • Marker: a unique string that identifies the subscription in the API.
  • Payment Account: select one of your existing accounts of type stripe, midtrans, or custom. For how to create accounts, see the payment accounts section (opens in a new tab).
  • Period (in days): how often payment is due to renew the subscription. For example, 30 makes a monthly subscription and 365 an annual one.
  • Products: select one or more products. The subscription cost is the sum of their prices. The list of available products comes from the catalog (opens in a new tab).

When you're done, click "Save". The subscription appears in the list and becomes available for subscribing through the API.

What to prepare in advance

To fully set up a subscription, you need:

  • at least one payment account (stripe, midtrans, or custom), which you select in the "Selection of payment accounts" field;
  • products in the catalog, whose prices make up the subscription cost.

Without a payment account and products, you can't save a subscription with working parameters.

Editing a subscription​

To edit a subscription, click the edit icon Edit in its row.

You can change the same fields as when creating it: name, payment account, period, and the products it includes.

info

If you change the price of a product included in a subscription, the cost of all active subscriptions with that product is recalculated automatically. The new cost applies starting from the next billing period; the current paid period isn't affected.

Deleting a subscription​

To delete a subscription, click the delete icon Delete in its row and confirm in the dialog.

info

Deleting a subscription in the admin panel doesn't automatically cancel subscriptions that users have already taken out. Active stripe and midtrans subscriptions keep being charged until the end of the current period and then stop renewing. custom subscriptions stay in the user card until they are explicitly canceled.

Last updated on