Pricing options

Use this object to add/create and edit/update price options for your account.

Request parameters

Parameter
Type / Description

PriceOptionsGroup

Object

Name

String

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.

Description

String

Pricing option group description.

Translations

Array of objects

Details below.

Translations.Name

String

Product pricing options group name, localized under Options.

Translations.Description

String

Product pricing options group description, localized under Options.

Translations.Language

String

ISO language code (ISO 639-1 two-letter code).

Code

String

Unique code that The 2Checkout system generates or set for each pricing options group.

Type

String

The type of the pricing options group. Possible values:

  • RADIO

  • CHECKBOX

  • INTERVAL

  • COMBO

Options

Array of objects

Details below.

Options.Name

String

Pricing option child name.

Options.Description

String

Pricing option child description.

Options.Translations

Array of objects

Localized fields (see Translations above).

Options.Translations.Name

String

Localized product pricing options group name under PriceOptionGroup; localized pricing option child name under Options.

Options.Translations.Description

String

Localized product pricing options group description under PriceOptionGroup; localized pricing option child description under Options.

Options.Translations.Language

String

ISO language code (ISO 639-1 two-letter code).

Options.Value

String

The code you set or that the 2Checkout system generated for each pricing option child inside a pricing options group parent.

Options.ScaleMin

Int

The minimum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.

Options.ScaleMax

Int

The maximum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.

Options.SubscriptionImpact

Object

Details below.

Options.SubscriptionImpact.Months

String

The value in months the 2Checkout system adds or subtracts from the initial billing cycle of a subscription.

Options.SubscriptionImpact.Impact

String

Possible values:

  • ADD

  • SUBTRACT

  • LIFETIME

Options.PriceImpact

Object

Details below.

Options.PriceImpact.ImpactOn

String

Possible values: BASE (impact on base price), GLOBAL (impact on calculated sum).

Options.PriceImpact.Impact

String

Impact on price per unit: ADD, SUBTRACT

Options.PriceImpact.Percent

String

The value of the percentage out of the price per product unit, when you use PERCENT for Method.

Options.PriceImpact.Method

String

Possible values: PERCENT, FIXED

Options.PriceImpact.Amounts

Array of objects

Details below.

Options.PriceImpact.Amounts.Currency

String

Currency ISO code (ISO 4217).

Options.PriceImpact.Amounts.Amount

String

The amount defined for each specific currency active for your account, when you use FIXED for Method.

Options.Default

Boolean

TRUE for preselected options. Missing for options that are not preselected.

Last updated

Was this helpful?