Subotiz package recurring pricing allows merchants to charge a set price for a predefined quantity of product units on a recurring billing cycle. This package pricing model supports course bundles, credit packages, download packages, and other subscription billing scenarios where products are sold in fixed quantities.
Before creating pricing, create the corresponding product. For details about products and pricing, see Products|Products and Pricing and Products | Understanding Pricing.
Creating Package Recurring Pricing
- Open Products: Log in to the Subotiz admin and go to Products > Products.
-
Start creating pricing: Locate the product and open the pricing creation page based on whether pricing already exists:
- No pricing created: Click Add price under the pricing count.
- Pricing already exists: Select the product to open its details, open the Prices tab, then click Create pricing.
-
Enter basic information: Under Basic info, confirm the associated Product, then enter a Name. The name is visible to customers and appears at checkout and on invoices.
- For example, for the Language Learning App product, enter Premium Vocabulary Practice Package as the pricing name.
- Select Recurring: Under Pricing configuration > Billing type, select Recurring.
- Select Package: Under Pricing model, select Package. Package pricing charges a set price for a predefined number of product units. If billing based on actual customer usage is not required, leave Usage-based billing disabled.
-
Set the package price and included quantity: Under Pricing configuration, enter the Package price and Included quantity:
- Package price: Enter the amount charged for each package. Pricing supports up to 14 decimal places.
-
Included quantity: Enter the number of product units included in each package.
- For example, set the package price to CA$20.00 and the included quantity to 100 units. If a customer purchases 250 units, the system calculates the charge based on 3 packages, for a total of CA$60.00.
- Preview billing: Click Preview billing, enter the Purchase quantity, and review the estimated charge based on the package price and included quantity. Preview amounts exclude discounts and taxes and are for reference only.

-
Set the billing cycle: Under Cycle configuration > Billing cycle, select the subscription billing cycle. Supported options include Daily, Weekly, Monthly, Quarterly, Yearly, Custom, and Customer-initiated payment.
- Custom: Set a cycle quantity from 2–365 and select Day, Week, Month, Quarter, or Year as the unit. For example, setting the cycle to Every 2 Months creates a billing cycle that renews every two months.
- Customer-initiated payment: The system does not process automatic recurring renewals. Subsequent payments must be initiated by the customer.
-
Enter additional information: Under More info, confirm the Currency, enter a Description, and optionally enter a Merchant pricing ID.
- Currency: Product pricing must be configured in the store's primary currency. When accepting payments in another supported currency, the system converts the product price to the specified settlement currency during settlement based on the applicable exchange rate. For details about supported currencies, currency conversion, and settlement, see Subotiz Payments|Multi-Currency Payments and Settlement.
- Description: Enter a customer-facing description that appears at checkout and on invoices. For example, enter Premium Vocabulary Practice Package with a set number of vocabulary practice units each month, full course access, and speaking challenges.
- Merchant pricing ID (optional): Enter a unique identifier for the pricing in the merchant's own system. The ID is returned with related orders and subscriptions.
-
Configure pricing features: Under Features, enable the product features included with the pricing and complete any required configuration based on the feature type.
- Quantitative features: Enter the quantity included with the pricing.
-
Qualitative features: Specify whether the feature is included.
- For example, the Premium Vocabulary Practice Package can include Daily lessons, Vocabulary practice, and Speaking challenges.
-
Save or activate pricing: Choose an option based on whether the pricing is ready for use:
- Save pricing as inactive: Click Save to create the pricing with an Inactive status.
- Create and activate pricing: Click Create & activate to create and immediately activate the pricing.
Note: Pricing can only be used for new sales and checkout when both the product and its corresponding pricing are Active.
Viewing the Customer Checkout Page
After package recurring pricing is created and used for a subscription, customers can view the product information, subscription price, current amount due, and upcoming billing information at checkout, then complete the subscription using an available payment method.

Managing Package Recurring Pricing
Existing package recurring pricing can be edited, activated, or deactivated. Changes to pricing do not overwrite the original pricing information associated with existing transactions and subscriptions. Existing subscriptions continue using their applicable original pricing configuration, while updated pricing applies to subsequently created transactions and subscriptions.
For instructions on editing, activating, and deactivating pricing, see Products | Manage Pricing. For details about how product and pricing changes affect existing records, see Products|Product and Pricing Update Behavior.
Package recurring pricing supports subscription models that charge recurring fees for predefined quantities of product units. Merchants can combine package price, included quantity, billing cycles, and product features to create clear recurring billing rules for different subscription scenarios.