Skip to main content
Anchor to SellingPlanBillingPolicy

SellingPlanBillingPolicy

union

Requires read_products access scope.

Represents the billing frequency associated to the selling plan (for example, bill every week, or bill every three months). The selling plan billing policy and associated records (selling plan groups, selling plans, pricing policies, 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 SellingPlanFixedBillingPolicySellingPlanFixedBillingPolicy
•OBJECT

The fixed selling plan billing policy defines how much of the price of the product will be billed to customer at checkout. If there is an outstanding balance, it determines when it will be paid.

Anchor to SellingPlanRecurringBillingPolicySellingPlanRecurringBillingPolicy
•OBJECT

Represents a recurring selling plan billing policy.

Was this section helpful?

Anchor to Fields with this unionFields with this union

Anchor to SellingPlan.billingPolicySellingPlan.billingPolicy
•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?