Set Package Pricing

Configures pricing for a plan or addon, supporting various billing models.

Mutation

Mutation

mutation SetPackagePricing($input: PackagePricingInput!) {
  setPackagePricing(input: $input) {
    packageId
    prices {
      billingModel
      billingPeriod
      billingCadence
      price {
        amount
        currency
      }
      tiers {
        upTo
        unitPrice {
          amount
          currency
        }
      }
    }
  }
}

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "FLAT_FEE",
        "billingPeriod": "MONTHLY",
        "price": {
          "amount": 99,
          "currency": "USD"
        }
      },
      {
        "billingModel": "FLAT_FEE",
        "billingPeriod": "ANNUAL",
        "price": {
          "amount": 990,
          "currency": "USD"
        }
      }
    ]
  }
}

{
  "data": {
    "setPackagePricing": {
      "packageId": "plan-uuid-123",
      "prices": [
        {
          "billingModel": "FLAT_FEE",
          "billingPeriod": "MONTHLY",
          "billingCadence": "RECURRING",
          "price": {
            "amount": 99,
            "currency": "USD"
          },
          "tiers": null
        },
        {
          "billingModel": "FLAT_FEE",
          "billingPeriod": "ANNUAL",
          "billingCadence": "RECURRING",
          "price": {
            "amount": 990,
            "currency": "USD"
          },
          "tiers": null
        }
      ]
    }
  }
}

Parameters

input · PackagePricingInput · required

Input for setting package pricing

Show properties

packageId · UUID · required

Plan or addon internal ID

pricingType · PricingType · required

FREE, PAID, or CUSTOM

prices · [PriceInput] · required

Array of price configurations

Show nested properties

billingModel · BillingModel · required

FLAT_FEE, USAGE_BASED, TIERED, CREDIT_BASED

billingPeriod · BillingPeriod · required

MONTHLY, ANNUAL

billingCadence · BillingCadence

RECURRING or ONE_OFF

price · MoneyInputDTO

Price amount and currency

featureId · String

Feature ID for usage-based pricing

tiers · [PriceTierInput]

Tiers for tiered pricing

blockSize · Float

Units per block for metered pricing

environmentId · UUID

Environment ID

Billing Models

Model	Description
FLAT_FEE	Fixed recurring price
USAGE_BASED	Based on metered usage
TIERED	Volume-based tiers
CREDIT_BASED	Deduct from credit balance

Examples

Flat Fee Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "FLAT_FEE",
        "billingPeriod": "MONTHLY",
        "price": { "amount": 99, "currency": "USD" }
      }
    ]
  }
}

Usage-Based Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "USAGE_BASED",
        "billingPeriod": "MONTHLY",
        "featureId": "feature-api-calls",
        "price": { "amount": 0.01, "currency": "USD" }
      }
    ]
  }
}

Tiered Pricing

{
  "input": {
    "packageId": "plan-uuid-123",
    "pricingType": "PAID",
    "prices": [
      {
        "billingModel": "TIERED",
        "billingPeriod": "MONTHLY",
        "featureId": "feature-api-calls",
        "tiers": [
          { "upTo": 1000, "unitPrice": { "amount": 0, "currency": "USD" } },
          { "upTo": 10000, "unitPrice": { "amount": 0.01, "currency": "USD" } },
          { "upTo": null, "unitPrice": { "amount": 0.005, "currency": "USD" } }
        ]
      }
    ]
  }
}

Related Operations

• Create Plan - Create plan
• Create Addon - Create addon
• Publish Plan - Publish plan