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 Details 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.Months

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

Options.Impact

String Possible values:

  • ADD

  • SUBTRACT

  • LIFETIME

Options.PriceImpact

Object Details below.

Options.PriceImpact.ImpactOn

String

Possible values:

  • BASE corresponding to impact on base price

  • GLOBAL for 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.

Required

Boolean True if you made the pricing option group mandatory.

Last updated

Was this helpful?