# Promotions

## GET /products/{ProductCode}/promotions/

> Retrieve all promotions set for a product

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/products/{ProductCode}/promotions/":{"get":{"tags":["Promotions"],"summary":"Retrieve all promotions set for a product","parameters":[{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","default":"application/json","enum":["application/json"]}},{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"ProductCode","in":"path","description":"The editable code that you control at product-level, not the unique, system-generated product ID","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}
```

## GET /products/{ProductCode}/promotions/{PromotionCode}/

> Retrieve a product's promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/products/{ProductCode}/promotions/{PromotionCode}/":{"get":{"tags":["Promotions"],"summary":"Retrieve a product's promotion","parameters":[{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","default":"application/json","enum":["application/json"]}},{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"ProductCode","in":"path","description":"The editable code that you control at product-level, not the unique, system-generated product ID","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"PromotionCode","in":"path","description":"Unique, system-generated identifier 2Checkout associates with promotion campaigns.","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}
```

## GET /promotions/

> Retrieve all active promotions

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/":{"get":{"tags":["Promotions"],"summary":"Retrieve all active promotions","parameters":[{"name":"Types","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"string","enum":["REGULAR","GLOBAL","RENEWAL","SPECIAL_PRICE","CUMULATIVE"]}},{"name":"Channel","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"string","enum":["ALL","CHANNEL_MANAGER","ECOMMERCE"]}},{"name":"Enabled","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"boolean"}},{"name":"Coupons","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"string"}},{"name":"ProductCode","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"string"}},{"name":"Page","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"number"}},{"name":"Limit","in":"query","required":false,"style":"form","explode":true,"schema":{"type":"number"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","default":"application/json","enum":["application/json"]}},{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPromotionsResponse"}}}}}}}},"components":{"schemas":{"GetPromotionsResponse":{"type":"object","properties":{"Items":{"$ref":"#/components/schemas/PromotionResponse"},"Pagination":{"$ref":"#/components/schemas/Pagination"}}},"PromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscount"},"Products":{"$ref":"#/components/schemas/PromotionProducts"},"PriceThreshold":{"$ref":"#/components/schemas/PromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"PromotionCoupon":{"type":"object","properties":{"Type":{"type":"string","description":"coupon type (SINGLE or MULTIPLE)"},"Code":{"type":"string","description":"coupon code"}}},"PromotionDiscount":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED / PERCENT)"},"Value":{"type":"number","description":"discount value"},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionProducts":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}},"PromotionProduct":{"type":"object","properties":{"Code":{"type":"string","description":"Promotion code."},"PricingConfigurationCode":{"type":"string","description":"Pricing configuration code."},"PricingOptionCodes":{"type":"array","items":{"type":"string"}}}},"PromotionPriceThreshold":{"type":"object","properties":{"Currency":{"type":"string","description":"price threshold currency"},"Amount":{"type":"number","description":"price threshold amount"}}},"PromotionTranslations":{"type":"array","items":{"$ref":"#/components/schemas/PromotionTranslation"}},"PromotionTranslation":{"type":"object","properties":{"Name":{"type":"string","description":"Translation text."},"Language":{"type":"string","description":"Translation language code."}}},"Pagination":{"type":"object","properties":{"Page":{"type":"integer"},"Limit":{"type":"integer"},"Count":{"type":"integer"}}}}}}
```

## POST /promotions/

> Add a new promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/":{"post":{"tags":["Promotions"],"summary":"Add a new promotion","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RegularPromotion"},{"$ref":"#/components/schemas/GlobalPromotion"},{"$ref":"#/components/schemas/SpecialPricePromotion"},{"$ref":"#/components/schemas/CumulativePromotion"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PromotionResponse"},{"$ref":"#/components/schemas/GlobalPromotionResponse"},{"$ref":"#/components/schemas/SpecialPricePromotionResponse"},{"$ref":"#/components/schemas/CumulativePromotionResponse"}]}}}}}}}},"components":{"schemas":{"RegularPromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"ChannelType":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Discount":{"$ref":"#/components/schemas/promotions_Discount"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"PublishToAffiliatesNetwork":{"type":"number"},"StartDate":{"type":"string"},"Type":{"type":"string"}}},"promotions_Coupon":{"type":"object","properties":{"Codes":{"type":"array","items":{"type":"string"}},"Type":{"type":"string"}}},"promotions_Discount":{"type":"object","properties":{"Type":{"type":"string"},"Value":{"type":"number"}}},"promotions_Products":{"type":"object","properties":{"Code":{"type":"string"}}},"GlobalPromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"ChannelType":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscountFixed"},"PriceThreshold":{"$ref":"#/components/schemas/GlobalPromotionPriceThreshold"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"PublishToAffiliatesNetwork":{"type":"number"},"StartDate":{"type":"string"},"Type":{"type":"string"}}},"PromotionDiscountFixed":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED)"},"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionDiscountAmount"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionDiscountAmount":{"type":"object","properties":{"Currency":{"type":"string","description":"price discount currency"},"Amount":{"type":"number","description":"price discount amount"}}},"GlobalPromotionPriceThreshold":{"type":"object","properties":{"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionPriceThreshold"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionPriceThreshold":{"type":"object","properties":{"Currency":{"type":"string","description":"price threshold currency"},"Amount":{"type":"number","description":"price threshold amount"}}},"SpecialPricePromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"priceMatrixPrice":{"type":"object","properties":{"ProductCode":{"type":"string","description":"product code"},"PricingConfigurationCode":{"type":"string","description":"pricing configuration code"},"OptionHash":{"type":"string","description":"hash generated based on price options"},"Options":{"type":"array","items":{"type":"object","description":"price options info","properties":{"GroupName":{"type":"string"},"OptionText":{"type":"string"}}}},"Prices":{"type":"array","items":{"type":"object","properties":{"Value":{"type":"number"},"Currency":{"type":"string"}}}}}},"CumulativePromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Cumulative":{"type":"boolean"},"ProductTaxCategoryUUID":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"PromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscount"},"Products":{"$ref":"#/components/schemas/PromotionProducts"},"PriceThreshold":{"$ref":"#/components/schemas/PromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"PromotionCoupon":{"type":"object","properties":{"Type":{"type":"string","description":"coupon type (SINGLE or MULTIPLE)"},"Code":{"type":"string","description":"coupon code"}}},"PromotionDiscount":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED / PERCENT)"},"Value":{"type":"number","description":"discount value"},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionProducts":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}},"PromotionProduct":{"type":"object","properties":{"Code":{"type":"string","description":"Promotion code."},"PricingConfigurationCode":{"type":"string","description":"Pricing configuration code."},"PricingOptionCodes":{"type":"array","items":{"type":"string"}}}},"PromotionTranslations":{"type":"array","items":{"$ref":"#/components/schemas/PromotionTranslation"}},"PromotionTranslation":{"type":"object","properties":{"Name":{"type":"string","description":"Translation text."},"Language":{"type":"string","description":"Translation language code."}}},"GlobalPromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscountFixed"},"PriceThreshold":{"$ref":"#/components/schemas/GlobalPromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"SpecialPricePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"CumulativePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Cumulative":{"type":"boolean"},"ProductTaxCategoryUUID":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}}}}}
```

## GET /promotions/{PromotionCode}/

> Retrieve a promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/":{"get":{"tags":["Promotions"],"summary":"Retrieve a promotion","parameters":[{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","default":"application/json","enum":["application/json"]}},{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"PromotionCode","in":"path","description":"Unique, system-generated identifier 2Checkout associates with promotion campaigns.","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PromotionResponse"},{"$ref":"#/components/schemas/GlobalPromotionResponse"},{"$ref":"#/components/schemas/SpecialPricePromotionResponse"},{"$ref":"#/components/schemas/CumulativePromotionResponse"}]}}}}}}}},"components":{"schemas":{"PromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscount"},"Products":{"$ref":"#/components/schemas/PromotionProducts"},"PriceThreshold":{"$ref":"#/components/schemas/PromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"PromotionCoupon":{"type":"object","properties":{"Type":{"type":"string","description":"coupon type (SINGLE or MULTIPLE)"},"Code":{"type":"string","description":"coupon code"}}},"PromotionDiscount":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED / PERCENT)"},"Value":{"type":"number","description":"discount value"},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionProducts":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}},"PromotionProduct":{"type":"object","properties":{"Code":{"type":"string","description":"Promotion code."},"PricingConfigurationCode":{"type":"string","description":"Pricing configuration code."},"PricingOptionCodes":{"type":"array","items":{"type":"string"}}}},"PromotionPriceThreshold":{"type":"object","properties":{"Currency":{"type":"string","description":"price threshold currency"},"Amount":{"type":"number","description":"price threshold amount"}}},"PromotionTranslations":{"type":"array","items":{"$ref":"#/components/schemas/PromotionTranslation"}},"PromotionTranslation":{"type":"object","properties":{"Name":{"type":"string","description":"Translation text."},"Language":{"type":"string","description":"Translation language code."}}},"GlobalPromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscountFixed"},"PriceThreshold":{"$ref":"#/components/schemas/GlobalPromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"PromotionDiscountFixed":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED)"},"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionDiscountAmount"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionDiscountAmount":{"type":"object","properties":{"Currency":{"type":"string","description":"price discount currency"},"Amount":{"type":"number","description":"price discount amount"}}},"GlobalPromotionPriceThreshold":{"type":"object","properties":{"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionPriceThreshold"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"SpecialPricePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"promotions_Coupon":{"type":"object","properties":{"Codes":{"type":"array","items":{"type":"string"}},"Type":{"type":"string"}}},"promotions_Products":{"type":"object","properties":{"Code":{"type":"string"}}},"priceMatrixPrice":{"type":"object","properties":{"ProductCode":{"type":"string","description":"product code"},"PricingConfigurationCode":{"type":"string","description":"pricing configuration code"},"OptionHash":{"type":"string","description":"hash generated based on price options"},"Options":{"type":"array","items":{"type":"object","description":"price options info","properties":{"GroupName":{"type":"string"},"OptionText":{"type":"string"}}}},"Prices":{"type":"array","items":{"type":"object","properties":{"Value":{"type":"number"},"Currency":{"type":"string"}}}}}},"CumulativePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Cumulative":{"type":"boolean"},"ProductTaxCategoryUUID":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}}}}}
```

## PUT /promotions/{PromotionCode}/

> Update a promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/":{"put":{"tags":["Promotions"],"summary":"Update a promotion","parameters":[{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","default":"application/json","enum":["application/json"]}},{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"PromotionCode","in":"path","description":"Unique, system-generated identifier 2Checkout associates with promotion campaigns.","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RegularPromotion"},{"$ref":"#/components/schemas/GlobalPromotion"},{"$ref":"#/components/schemas/SpecialPricePromotion"},{"$ref":"#/components/schemas/CumulativePromotion"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PromotionResponse"},{"$ref":"#/components/schemas/GlobalPromotionResponse"},{"$ref":"#/components/schemas/SpecialPricePromotionResponse"},{"$ref":"#/components/schemas/CumulativePromotionResponse"}]}}}}}}}},"components":{"schemas":{"RegularPromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"ChannelType":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Discount":{"$ref":"#/components/schemas/promotions_Discount"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"PublishToAffiliatesNetwork":{"type":"number"},"StartDate":{"type":"string"},"Type":{"type":"string"}}},"promotions_Coupon":{"type":"object","properties":{"Codes":{"type":"array","items":{"type":"string"}},"Type":{"type":"string"}}},"promotions_Discount":{"type":"object","properties":{"Type":{"type":"string"},"Value":{"type":"number"}}},"promotions_Products":{"type":"object","properties":{"Code":{"type":"string"}}},"GlobalPromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"ChannelType":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscountFixed"},"PriceThreshold":{"$ref":"#/components/schemas/GlobalPromotionPriceThreshold"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"PublishToAffiliatesNetwork":{"type":"number"},"StartDate":{"type":"string"},"Type":{"type":"string"}}},"PromotionDiscountFixed":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED)"},"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionDiscountAmount"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionDiscountAmount":{"type":"object","properties":{"Currency":{"type":"string","description":"price discount currency"},"Amount":{"type":"number","description":"price discount amount"}}},"GlobalPromotionPriceThreshold":{"type":"object","properties":{"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionPriceThreshold"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionPriceThreshold":{"type":"object","properties":{"Currency":{"type":"string","description":"price threshold currency"},"Amount":{"type":"number","description":"price threshold amount"}}},"SpecialPricePromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"priceMatrixPrice":{"type":"object","properties":{"ProductCode":{"type":"string","description":"product code"},"PricingConfigurationCode":{"type":"string","description":"pricing configuration code"},"OptionHash":{"type":"string","description":"hash generated based on price options"},"Options":{"type":"array","items":{"type":"object","description":"price options info","properties":{"GroupName":{"type":"string"},"OptionText":{"type":"string"}}}},"Prices":{"type":"array","items":{"type":"object","properties":{"Value":{"type":"number"},"Currency":{"type":"string"}}}}}},"CumulativePromotion":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Cumulative":{"type":"boolean"},"ProductTaxCategoryUUID":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"PromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscount"},"Products":{"$ref":"#/components/schemas/PromotionProducts"},"PriceThreshold":{"$ref":"#/components/schemas/PromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"PromotionCoupon":{"type":"object","properties":{"Type":{"type":"string","description":"coupon type (SINGLE or MULTIPLE)"},"Code":{"type":"string","description":"coupon code"}}},"PromotionDiscount":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED / PERCENT)"},"Value":{"type":"number","description":"discount value"},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionProducts":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}},"PromotionProduct":{"type":"object","properties":{"Code":{"type":"string","description":"Promotion code."},"PricingConfigurationCode":{"type":"string","description":"Pricing configuration code."},"PricingOptionCodes":{"type":"array","items":{"type":"string"}}}},"PromotionTranslations":{"type":"array","items":{"$ref":"#/components/schemas/PromotionTranslation"}},"PromotionTranslation":{"type":"object","properties":{"Name":{"type":"string","description":"Translation text."},"Language":{"type":"string","description":"Translation language code."}}},"GlobalPromotionResponse":{"type":"object","properties":{"Code":{"type":"string","description":"promotion code"},"Name":{"type":"string","description":"promotion name"},"Description":{"type":"string","description":"promotion description"},"StartDate":{"type":"string","description":"promotion start date"},"EndDate":{"type":"string","description":"promotion end date"},"MaximumOrdersNumber":{"type":"number","description":"promotion maximum number of orders"},"MaximumQuantity":{"type":"number","description":"promotion maximum number of products"},"InstantDiscount":{"type":"boolean","description":"instant discount applied to the promotion"},"Coupon":{"$ref":"#/components/schemas/PromotionCoupon"},"Enabled":{"type":"boolean"},"ChannelType":{"type":"string"},"Type":{"type":"string"},"Discount":{"$ref":"#/components/schemas/PromotionDiscountFixed"},"PriceThreshold":{"$ref":"#/components/schemas/GlobalPromotionPriceThreshold"},"Translations":{"$ref":"#/components/schemas/PromotionTranslations"},"Sources":{"type":"array","items":{"type":"string"}},"PublishToAffiliatesNetwork":{"type":"number"},"ApplyRecurring":{"type":"string"},"RecurringChargesNumber":{"type":"number","description":"number of recurring charges to apply the promotion to"}}},"SpecialPricePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}},"CumulativePromotionResponse":{"type":"object","properties":{"ApplyRecurring":{"type":"string"},"Coupon":{"$ref":"#/components/schemas/promotions_Coupon"},"Description":{"type":"string"},"Enabled":{"type":"boolean"},"EndDate":{"type":"string"},"InstantDiscount":{"type":"number"},"MaximumOrdersNumber":{"type":"number"},"MaximumQuantity":{"type":"number"},"Name":{"type":"string"},"StartDate":{"type":"string"},"Type":{"type":"string"},"Cumulative":{"type":"boolean"},"ProductTaxCategoryUUID":{"type":"string"},"Products":{"type":"array","items":{"$ref":"#/components/schemas/promotions_Products"}},"DefaultCurrency":{"type":"string"},"PriceMatrix":{"type":"array","items":{"$ref":"#/components/schemas/priceMatrixPrice"}}}}}}}
```

## POST /promotions/{PromotionCode}/coupons/

> Add promotion coupon

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/coupons/":{"post":{"tags":["Promotions"],"summary":"Add promotion coupon","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/body_14"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}},"components":{"schemas":{"body_14":{"type":"object","properties":{"Code":{"type":"string"},"Type":{"type":"string"}}}}}}
```

## PUT /promotions/{PromotionCode}/coupons/

> Update promotion coupon

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/coupons/":{"put":{"tags":["Promotions"],"summary":"Update promotion coupon","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromotionCoupon"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}},"components":{"schemas":{"PromotionCoupon":{"type":"object","properties":{"Type":{"type":"string","description":"coupon type (SINGLE or MULTIPLE)"},"Code":{"type":"string","description":"coupon code"}}}}}}
```

## DELETE /promotions/{PromotionCode}/coupons/

> Delete promotion coupons

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/coupons/":{"delete":{"tags":["Promotions"],"summary":"Delete promotion coupons","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}
```

## POST /promotions/{PromotionCode}/products/

> Add products to a promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/products/":{"post":{"tags":["Promotions"],"summary":"Add products to a promotion","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromotionProduct"}}}}}}}}},"components":{"schemas":{"PromotionProduct":{"type":"object","properties":{"Code":{"type":"string","description":"Promotion code."},"PricingConfigurationCode":{"type":"string","description":"Pricing configuration code."},"PricingOptionCodes":{"type":"array","items":{"type":"string"}}}}}}}
```

## DELETE /promotions/{PromotionCode}/products/

> Remove products from a promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/products/":{"delete":{"tags":["Promotions"],"summary":"Remove products from a promotion","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}}}}
```

## POST /promotions/{PromotionCode}/sources/

> Add promotion sources

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/sources/":{"post":{"tags":["Promotions"],"summary":"Add promotion sources","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionSources"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}},"components":{"schemas":{"PromotionSources":{"type":"object","properties":{"SOURCE_1":{"type":"string"},"SOURCE_2":{"type":"string"},"SOURCE_3":{"type":"string"}}}}}}
```

## DELETE /promotions/{PromotionCode}/sources/

> Delete promotion sources

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/sources/":{"delete":{"tags":["Promotions"],"summary":"Delete promotion sources","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}
```

## PUT /promotions/{PromotionCode}/translations/

> Add promotion translations

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/translations/":{"put":{"tags":["Promotions"],"summary":"Add promotion translations","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionTranslations"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionTranslations"}}}}}}}},"components":{"schemas":{"PromotionTranslations":{"type":"array","items":{"$ref":"#/components/schemas/PromotionTranslation"}},"PromotionTranslation":{"type":"object","properties":{"Name":{"type":"string","description":"Translation text."},"Language":{"type":"string","description":"Translation language code."}}}}}}
```

## DELETE /promotions/{PromotionCode}/translations/

> Delete promotion translations

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/promotions/{PromotionCode}/translations/":{"delete":{"tags":["Promotions"],"summary":"Delete promotion translations","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{}}}}}}}}
```

## PUT /{PromotionCode}/discounts/

> Update the discounts for a promotion

```json
{"openapi":"3.0.0","info":{"title":"API REST Documentation","version":"6.0-oas3"},"servers":[{"url":"https://api.2checkout.com/rest/6.0"}],"paths":{"/{PromotionCode}/discounts/":{"put":{"tags":["Promotions"],"summary":"Update the discounts for a promotion","parameters":[{"name":"X-Avangate-Authentication","in":"header","description":"Authentication header","required":true,"style":"simple","explode":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","required":true,"style":"simple","explode":false,"schema":{"type":"string","enum":["application/json"]}},{"name":"PromotionCode","in":"path","description":"Unique system generated promotion code","required":true,"style":"simple","explode":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PromotionDiscountFixed"},{"$ref":"#/components/schemas/PromotionDiscountPercent"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PromotionDiscountFixed"},{"$ref":"#/components/schemas/PromotionDiscountPercent"}]}}}}}}}},"components":{"schemas":{"PromotionDiscountFixed":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (FIXED)"},"Values":{"type":"array","items":{"$ref":"#/components/schemas/PromotionDiscountAmount"}},"DefaultCurrency":{"type":"string","description":"promotion currency"}}},"PromotionDiscountAmount":{"type":"object","properties":{"Currency":{"type":"string","description":"price discount currency"},"Amount":{"type":"number","description":"price discount amount"}}},"PromotionDiscountPercent":{"type":"object","properties":{"Type":{"type":"string","description":"discount type (PERCENT)"},"Value":{"type":"integer","description":"the value of the percentage discount"}}}}}}
```


---

# 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/api-reference/reference/promotions.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.