---
title: SellingPlanBillingPolicy - GraphQL Admin
description: |-
  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.
api_version: 2025-10
api_name: admin
type: union
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/unions/sellingplanbillingpolicy
  md: https://shopify.dev/docs/api/admin-graphql/latest/unions/sellingplanbillingpolicy.md
---

# Selling​Plan​Billing​Policy

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.

## Possible types

* [Selling​Plan​Fixed​Billing​Policy](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanFixedBillingPolicy)

  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.

  * checkout​Charge

    [Selling​Plan​Checkout​Charge!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanCheckoutCharge)

    non-null

    The checkout charge when the full amount isn't charged at checkout.

  * remaining​Balance​Charge​Exact​Time

    [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

    The exact time when to capture the full payment.

  * remaining​Balance​Charge​Time​After​Checkout

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    The period after remaining\_balance\_charge\_trigger, before capturing the full payment. Expressed as an ISO8601 duration.

  * remaining​Balance​Charge​Trigger

    [Selling​Plan​Remaining​Balance​Charge​Trigger!](https://shopify.dev/docs/api/admin-graphql/latest/enums/SellingPlanRemainingBalanceChargeTrigger)

    non-null

    When to capture payment for amount due.

* [Selling​Plan​Recurring​Billing​Policy](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanRecurringBillingPolicy)

  OBJECT

  Represents a recurring selling plan billing policy.

  * anchors

    [\[Selling​Plan​Anchor!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanAnchor)

    non-null

    Specific anchor dates upon which the billing interval calculations should be made.

  * created​At

    [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

    non-null

    The date and time when the selling plan billing policy was created.

  * interval

    [Selling​Plan​Interval!](https://shopify.dev/docs/api/admin-graphql/latest/enums/SellingPlanInterval)

    non-null

    The billing frequency, it can be either: day, week, month or year.

  * interval​Count

    [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    non-null

    The number of intervals between billings.

  * max​Cycles

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    Maximum number of billing iterations.

  * min​Cycles

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    Minimum number of billing iterations.

***

## Fields with this union

* [Selling​Plan.billingPolicy](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlan#field-SellingPlan.fields.billingPolicy)

  OBJECT

  Represents how a product can be sold and purchased. Selling plans and associated records (selling plan groups and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later.

  For more information on selling plans, refer to [*Creating and managing selling plans*](https://shopify.dev/docs/apps/selling-strategies/subscriptions/selling-plans).

***

```graphql
union SellingPlanBillingPolicy = SellingPlanFixedBillingPolicy | SellingPlanRecurringBillingPolicy
```