# Pricing option

This object is returned directly or within a successful response from the following API requests:

* [Retrieve a price option group](/json-rpc-api-reference/json-rpc-api-6.0/api-requests/pricing-options/retrieve-a-price-option-group.md)
* [Retrieve assigned price option groups](/json-rpc-api-reference/json-rpc-api-6.0/api-requests/pricing-options/retrieve-assigned-price-option-groups.md)
* [Search price option groups](/json-rpc-api-reference/json-rpc-api-6.0/api-requests/pricing-options/search-price-option-groups.md)

## Pricing option group

<table><thead><tr><th width="237.4666748046875">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>Name</code></td><td><p><strong>String</strong></p><p>Price option group name. Use this parameter when adding a new price options group. To edit the name of a price option group use the Name parameter under the Translations object.</p></td></tr><tr><td><code>Description</code></td><td><p><strong>String</strong></p><p>Pricing option group description.</p></td></tr><tr><td><code>Translations</code></td><td><p><strong>Array of objects</strong></p><p>Details below.</p></td></tr><tr><td><code>Translations.Name</code></td><td><p><strong>String</strong><br>Localized product pricing options group name under <code>PriceOptionGroup</code>.</p><p>Localized pricing option child name under Options.</p></td></tr><tr><td><code>Translations.Description</code></td><td><p><strong>String</strong><br>Localized product pricing options group description under <code>PriceOptionGroup</code>.</p><p>Localized pricing option child description under Options.</p></td></tr><tr><td><code>Translations.Language</code></td><td><strong>String</strong><br>ISO language code. (ISO 639-1 two-letter code).</td></tr><tr><td><code>Code</code></td><td><p><strong>String</strong></p><p>Unique code that The 2Checkout system generates or set for each pricing options group.</p></td></tr><tr><td><code>Type</code></td><td><p><strong>String</strong></p><p>The type of the pricing options group. Possible values: RADIO, CHECKBOX, INTERVAL, COMBO</p></td></tr><tr><td><code>Options</code></td><td><p>Array of <a href="#priceoption-object"><strong>PriceOption</strong></a> objects</p><p>Details below.</p></td></tr><tr><td><code>Usage</code></td><td><p><strong>String</strong></p><p>Defines the type of pricing for scale product options. Can be either regular (tiered pricing) or payperusage (metered billing).</p></td></tr></tbody></table>

### PriceOption (object)

<table><thead><tr><th width="197.9998779296875">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>Code</code></td><td><p><strong>String</strong></p><p>The code you set or that the 2Checkout system generated for each pricing option child inside a pricing options group parent.</p></td></tr><tr><td><code>ScaleMin</code></td><td><p><strong>Int</strong></p><p>The minimum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.</p></td></tr><tr><td><code>ScaleMax</code></td><td><p><strong>Int</strong></p><p>The maximum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.</p></td></tr><tr><td><a href="#subscriptionlifetimeimpact-object"><code>SubscriptionImpact</code></a></td><td><p><a href="#subscriptionlifetimeimpact-object"><strong>SubscriptionLifetimeImpact</strong></a> <strong>object</strong></p><p>Details below.</p></td></tr><tr><td><a href="#priceimpact-object"><code>PriceImpact</code></a></td><td><p><strong>Object</strong></p><p>Details below.</p></td></tr><tr><td><a href="#amounts-object"><code>Amounts</code></a></td><td><p><strong>Array of objects</strong></p><p>Details below.</p></td></tr><tr><td><code>Default</code></td><td><p><strong>Boolean</strong></p><p>TRUE for preselected options. Missing for options that are not preselected.</p></td></tr><tr><td><code>Name</code></td><td><p><strong>String</strong></p><p>Pricing option child name.</p></td></tr><tr><td><code>Description</code></td><td><p><strong>String</strong></p><p>Pricing option child description.</p></td></tr><tr><td><code>Translations</code></td><td><p><strong>Array of objects</strong></p><p>Details below.</p></td></tr></tbody></table>

#### **SubscriptionLifetimeImpact (object)**

<table><thead><tr><th width="121.199951171875">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>Months</code></td><td><p><strong>String</strong></p><p>The value in months the 2Checkout system adds or subtracts from the initial billing cycle of a subscription.</p></td></tr><tr><td><code>Impact</code></td><td><p><strong>String</strong></p><p>Possible values: ADD, SUBTRACT, LIFETIME</p></td></tr></tbody></table>

#### **PriceImpact (object)**

<table><thead><tr><th width="118">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>ImpactOn</code></td><td><p><strong>String</strong></p><p>Possible values: BASE (impact on base price), GLOBAL (impact on calculated sum).</p></td></tr><tr><td><code>Impact</code></td><td><p><strong>String</strong></p><p>Impact on price per unit: ADD, SUBTRACT</p></td></tr><tr><td><code>Percent</code></td><td><p><strong>String</strong></p><p>The value of the percentage out of the price per product unit, when you use PERCENT for Method.</p></td></tr><tr><td><code>Method</code></td><td><p><strong>String</strong></p><p>Possible values: PERCENT, FIXED</p></td></tr></tbody></table>

#### **Amounts (object)**

<table><thead><tr><th width="116.933349609375">Parameter</th><th>Type / Description</th></tr></thead><tbody><tr><td><code>Currency</code></td><td><p><strong>String</strong></p><p>Currency ISO code - ISO 4217.</p></td></tr><tr><td><code>Amount</code></td><td><p><strong>String</strong></p><p>The amount defined for each specific currency active for your account, when you use FIXED for Method.</p></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.2checkout.com/json-rpc-api-reference/json-rpc-api-6.0/api-responses/pricing-option.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.