About Wix Pricing Plans

Wix Pricing Plans includes Plans and Orders, and allows Wix users to build a customized membership plan experiences and sell them to their customers.

• With Plans, a Wix user can create different types of plans, such as, free, one-time or recurring subscriptions.
• With Orders, a Wix user can create and manage the purchases of these plans.

Integrations

Wix users can use Wix Pricing Plans together with other Wix business solutions.

Pricing Plans can be used together with the following Wix business solutions:

• Wix Bookings - services from Wix Bookings (classes, treatments, workshops, etc.) can be included as a part of a plan (e.g. a plan for 10 private yoga classes).
• Wix Blog - blog (list of posts or a single complete post) can be limited to paying members who purchase a particular membership.
• Wix Forum - allow some forum categories to be accessible only for paying members.
• Wix Events - offer discounts on event tickets to paying members who purchase a particular membership.
• Wix File Share - access to files in your shared library can be limited to paying members.
• Wix Online Programs - access to an online program can be accessible only to paying members who purchase a particular membership.
• Wix Video - video channel access can be limited to paying members.
• Wix Groups - group membership can be accessible only to paying members who purchase a particular membership.

Learn more about connecting Pricing Plans to other Wix business solutions.

Plans and subscriptions

Every purchase of a pricing plan creates a new "subscription" to that plan for that buyer. Plans can be 1 of 3 different pricing models, subscription, singlePaymentForDuration, or singlePaymentUnlimited.

Pricing models

Pricing models contain the pricing and duration options for a plan.

Plans are based on a pricing model, which is defined with the plan's pricing property. A pricing model can be one of the following:

• A subscription: A plan with recurring payment cycles.

Example: A 1-year subscription with monthly, recurring payments. Each payment is $25, so the total price for the plan is $300.

cycleDuration is the length of 1 payment cycle. Multiply cycleDuration's count by cycleCount to get the subscription duration.

For specific orders of this plan, the index of currentCycle is the current payment cycle for the subscription. index is 0 when the order is in a free trial period. In all other cases, the index starts with 1 for the first payment cycle in the subscription. For orders with a single payment, the index will remain 1 throughout the duration.

In this example, the subscription of the plan is now in the 3rd month and the order looks like this:

• A Single Payment for Duration plan: A plan paid for with a single payment. The plan doesn't renew after the duration.

Example: A plan with a single payment of $35 for 3 months.

For specific orders of this plan, the duration cycleFrom and numberOfCycles will both be 1, as the single price applies to the entirety of the subscription. Also, the index of currentCycle will remain 1 throughout the duration.

• A Single Payment Unlimited plan: A plan paid for with a single payment. The plan doesn't expire and remains valid until canceled.

Example: An unlimited plan that's paid for in advance with a single payment of $200.

singlePaymentUnlimited is true.

For specific orders of this plan, the duration cycleFrom and numberOfCycles will remain 1 throughout the duration of the plan. Also, the index of currentCycle will remain 1 throughout the duration. singlePaymentUnlimitedPlans don't return an endedDate in currentCycle.

Free plans and free trial periods

A free plan that's valid until canceled is a singlePaymentUnlimited pricing model. A free plan with a limited duration is treated as a singlePaymentForDuration pricing model.

A Wix user can also add a free trial period, in days, to a subscription pricing model. When the free trial is over, the first payment cycle begins and the buyer is billed. During the free trial period, the index of currentCycle is 0. A buyer only receives the free trial period for the first time they purchase a plan. For example, a buyer purchases a monthly plan for 3 months that includes a 7-day free trial period. The buyer may purchase the same plan again, for another 3 months, but won't receive the 7-day free trial period.

When a buyer cancels their order during the free trial period, their subscription expires at the end of the free trial period and they won't be billed. A Wix user can cancel an ordered plan during the free trial period and choose to apply the cancellation IMMEDIATELY or at the NEXT_PAYMENT_DATE. Canceling at the NEXT_PAYMENT_DATE allows the buyer to continue using the benefits of the subscription until the end of the free trial period. Then, the subscription ends and the buyer isn't billed.

Extend Pricing Plans with the Benefit Programs API

Pricing plans are built on top of Wix's benefit programs infrastructure. This allows you to manage credit-based features, such as loyalty points, within your pricing plans using the Benefit Programs API.

When to use the Benefit Programs API

Use the Benefit Programs API when you need to make changes to credits associated with your pricing plans. Credits are units that can be consumed by plan members to access services or features.

To modify credit balances for pricing plan members, call Change Balance from the Benefit Programs API.

How pricing plans connect to benefit programs

Pricing Plans entities are linked to specific Benefit Programs entities:

• Plans: Linked to program definitions. The plan's id matches the linked program definition's externalId.
• Orders: Linked to programs. The order's id matches the linked program's externalId.

This connection allows you to use the order ID or plan ID to identify the corresponding benefit program when making credit-related changes.

If you work with pricing plan-related benefit programs, you need to specify @wix/pricing-plans as the namespace when calling Benefit Programs API methods. For example, specify it in Get Program By External Id And Namespace and inside the filter for Query Pools.