Skip to Content
Paddle integrationMapping prices to policies

Mapping prices to policies

A mapping links a price of your Paddle account to a policy of a product: paying that price creates licenses of the product, with the policy’s settings. A product can have as many mappings as you sell prices, and a price creates licenses of one product only.

Which prices can be mapped

  • Active catalog prices of active products: one-time prices, and recurring prices of any billing cycle.
  • Not custom prices, created for one transaction outside your catalog.
  • Not archived prices, nor prices of archived products.

Recurring prices need the Subscriptions: Read permission on the API key, checked when you map the first one. See subscriptions.

Create a mapping

Open the Integrations page

Open the product, click Integrations, then New mapping on the Paddle price mappings card.

Choose the Paddle price

The list shows your prices with their product, name and amount. Prices already mapped to a product are greyed out.

Choose the policy

The product’s default policy is preselected. It sets the expiration, machines and updates of the licenses created.

Create the mapping

From now on, paying the price creates licenses.

What a mapping creates

  • One-time prices: one license per unit bought, when the transaction is completed. Each license records its share of the item’s total, after discounts and before taxes.
  • Recurring prices: one license per subscription, valid while it’s paid, with the policy’s machines times the quantity subscribed. See subscriptions.

A transaction with several mapped items creates the licenses of each of them, and the customer receives all their keys in one email.

Change or delete a mapping

Change policy, in the mapping’s menu, only affects the licenses created afterwards. Delete stops the price from creating licenses; the licenses it created stay.

Mapping statuses

When a mapped price or its product is archived in Paddle, the mapping shows the reason, and the integration shows Error. Unarchive it in Paddle, or delete the mapping.