Choose a version:

SellingPlanPricingPolicy

union

Requires read_products access scope.

Represents the type of pricing associated to the selling plan (for example, a $10 or 20% discount that is set for a limited period or that is fixed for the duration of the subscription). Selling plan pricing policies and associated records (selling plan groups, selling plans, billing policy, and delivery policy) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later.

Anchor to Possible typesPossible types

Anchor to SellingPlanFixedPricingPolicy SellingPlanFixedPricingPolicy

•OBJECT

Represents the pricing policy of a subscription or deferred purchase option selling plan. The selling plan fixed pricing policy works with the billing and delivery policy to determine the final price. Discounts are divided among fulfillments. For example, a subscription with a $10 discount and two deliveries will have a $5 discount applied to each delivery.

Anchor to adjustmentTypeadjustmentType •SellingPlanPricingPolicyAdjustmentType! non-null: The price adjustment type.
Anchor to adjustmentValueadjustmentValue •SellingPlanPricingPolicyAdjustmentValue! non-null: The price adjustment value.
Anchor to createdAtcreatedAt •DateTime! non-null: The date and time when the fixed selling plan pricing policy was created.

Anchor to SellingPlanRecurringPricingPolicy SellingPlanRecurringPricingPolicy

•OBJECT

Represents a recurring selling plan pricing policy. It applies after the fixed pricing policy. By using the afterCycle parameter, you can specify the cycle when the recurring pricing policy comes into effect. Recurring pricing policies are not available for deferred purchase options.

Anchor to adjustmentTypeadjustmentType •SellingPlanPricingPolicyAdjustmentType! non-null: The price adjustment type.
Anchor to adjustmentValueadjustmentValue •SellingPlanPricingPolicyAdjustmentValue! non-null: The price adjustment value.
Anchor to afterCycleafterCycle •Int: Cycle after which this pricing policy applies.
Anchor to createdAtcreatedAt •DateTime! non-null: The date and time when the recurring selling plan pricing policy was created.

Was this section helpful?

Anchor to Fields with this unionFields with this union

Anchor to SellingPlan.pricingPolicies SellingPlan.pricingPolicies •OBJECT: How a product can be sold and purchased through recurring billing or deferred purchase options. Defines the specific terms for subscriptions, pre-orders, or try-before-you-buy offers, including when to bill customers, when to fulfill orders, and what pricing adjustments to apply.

Each selling plan has billing, delivery, and pricing policies that control the purchase experience. The plan's options and category help merchants organize and report on different selling strategies. Plans are grouped within a SellingPlanGroup that associates them with Product and ProductVariant objects.

Caution
Selling plans and associated records are automatically deleted 48 hours after a merchant uninstalls the App that created them. Back up these records if you need to restore them later.
Learn more about selling plans.

Was this section helpful?