Prices
Learn about Price objects in PayNowPro, including one-time and recurring prices, and validation rules within Product Groups.
The Price object represents how much and how often to charge for a Product.
Each Price object contains details like the amount, currency, and whether the price is for a one-time
purchase or a recurring subscription.
Every Price must be associated with a Product.
Types of Prices
Non-Recurring (One-Time) Prices
These represent a single, one-off charge for a product. They are defined by an amount and a currency.
Recurring Prices
These are used for subscriptions and include a recurring object that specifies a frequency (e.g., monthly, annually)
in addition to the amount and currency.
Rules within a Product Group
When you organize Products into a Product Group, PayNowPro enforces the following validation rules on their prices to ensure your offerings are consistent and unambiguous.
1. Uniform Currency
All prices for all products within a single Product Group must use the same currency. You cannot mix currencies within a group.
Example: If you have a "Hosting Plans" group and your "Starter Plan" product has a price in JMD, you cannot add a "Pro Plan" product with a price in USD to that same group. The entire group is locked to the currency of the first price that was added.
2. Unique Recurring Prices
Within a Product Group, you cannot have duplicate recurring prices. A duplicate is defined as having the same frequency and amount
combination. This rule ensures that every billing option across all products in the group is distinct.
Example: Consider a "Subscription Tiers" group:
- The "Basic Tier" product has a
monthlyprice of $2,000 JMD.- The "Premium Tier" product has a
monthlyprice of $4,000 JMD.In this scenario, you cannot add another product to this group that also has a
monthlyprice of $2,000 JMD, because that specific frequency-amount combination already exists on the "Basic Tier".