Price entities describe how much and how often you charge for your products. They hold charging information.
Prices describe the way that you charge for products in your catalog. They're linked to your products using product IDs.
Price entities hold information like:
- How much it costs
- What currency it's billed in
- Whether it's one-time or recurring
- How often it's billed, if recurring
- How long a trial period is, if any
You can add as many prices as you like against a product — especially useful for subscription plans. For example, a "Premium plan" product might have an annual price and a monthly price.
For country-specific pricing, use price overrides rather than creating multiple prices. Price overrides let you override your base price with a custom price and currency for any country.
Unique Paddle ID for this price, prefixed with
Paddle ID for the product that this price is for, prefixed with
Internal description for this price, not shown to customers. Typically notes for your team.
Type of price. Standard prices are considered part of your product catalog and are shown on the Paddle web app.
Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills.
How often this price should be charged.
null if price is non-recurring (one-time).
Unit of time.
Amount of time.
Trial period for the product related to this price. The billing cycle begins once the trial period is over.
null for no trial period. Requires
Unit of time.
Amount of time.
How tax is calculated for this price.
Base price. This price applies to all customers, except for customers located in countries where you have
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents).
Supported three-letter ISO 4217 currency code.
List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries.
Supported two-letter ISO 3166-1 alpha-2 country code.
Override price. This price applies to customers located in the countries for this unit price override.
Limits on how many times the related product can be purchased at this price. Useful for discount campaigns.
Minimum quantity of the product related to this price that can be bought. Required if
Maximum quantity of the product related to this price that can be bought. Required if
minimum set. Must be greater than or equal to the
Whether this entity can be used in Paddle.
Your own structured key-value data.
Import information for this entity.
null if this entity is not imported.
Reference or identifier for this entity from the solution where it was imported from.
Name of the platform where this entity was imported from.
RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.