Flexible Discounts for 3-Year Commitments (3YC)
Starting in June 2026, the Flexible Discounts program includes promotional pricing specifically designed for 3-Year Commitments (3YC). Partners can use these targeted promotions to incentivize customers to sign a new 3-year agreement or to reward those who already have an active 3YC. This automated feature eliminates the need to manually search for and identify eligible customers.
The mechanism used to discover and apply these discounts is exactly the same as standard flexible discounts. The system discovers available promotions using the GET /v3/flex-discounts API request. To apply the discount to an order, you simply include the flexDiscountCodes information in your new purchase or renewal order request.
3-Year Commitment (3YC) flexible discounts use the same underlying mechanisms, discovery calls, and order structures as standard flexible discounts. For foundational details regarding system requirements, feature activation parameters, general API payload formats, and overall discount management, please refer back to the main Flexible Discounts section.
Eligibility Rules
Flexible discounts for 3YC are categorized by the customer's current commitment status and the minimum purchase quantity (MPQ).
-
New to 3YC: This discount requires the customer to enter a 3-year commitment on the qualifying order. The customer must not have previously enrolled in a 3YC. Note that "New to 3YC" specifically refers to customers who achieve 3YC compliance through a new order, not customers who are just adding seats to an existing subscription. Customers who sign a new recommitment after a previous 3YC term has ended are considered "Existing 3YC" customers, not new. These discounts can be configured to apply only to the first year or across the full commitment term.
-
Minimum Commit Quantity (MCQ) Thresholds: Certain flexible discounts require the customer to meet a specific Minimum Commit Quantity threshold. The total of the new qualifying order quantity plus any existing quantity must meet or exceed this required MCQ threshold. Depending on the specific promotion, this can apply to new or existing 3YC customers for the first year, the current year, or the remaining term.
-
Non-3YC Customers: Some discounts are designed exclusively for customers who do not have an active 3YC. Customers who are entering or currently maintaining a 3-year commitment are excluded from these specific offers. These non-3YC discounts are only eligible within the customer's current subscription term.
Note:
- The connector fully supports CloudBlue Marketplace scenarios for brand new customers. A net new customer can seamlessly subscribe to a 3-Year Commitment and apply a valid 3-year flexible discount at the exact same time when placing a Sales Order.
- If an order fails validation due to unmet eligibility criteria (such as not meeting the required MCQ threshold or attempting to apply a "New to 3YC" discount to an existing 3YC account), the transaction will be rejected. For detailed descriptions of error responses and troubleshooting steps, please refer to the Adobe Error Codes Specific to Flexible Discounts documentation.
Application and Reusability
-
Reusable Discounts: Reusable 3YC discounts may remain active and eligible even after the official discount end date has passed, provided the customer continues to meet the 3YC criteria and past usage conditions.
-
Automatic vs. Manual Application: Reusable 3YC discounts can apply across multiple eligible orders. These discounts are applied automatically during renewal orders, but they must be explicitly applied by the partner for new orders.
-
Switch Orders: If a reusable discount is first applied during a switch order, it will not be automatically applied again on subsequent renewal orders.
-
Tracking: You can use the
discountLockEndDatefield alongside Preview Order APIs (such as Preview Renewal) to confirm how a discount will behave for a specific customer.
Sales Order Example
This payload demonstrates how a net-new customer can initiate a 3-Year Commitment and apply an eligible 3YC flexible discount simultaneously within a single Sales Order:
{
"type": "SALES",
"accountId": "e009fd0a-1b6a-4c6d-9d17-0738d14cccb4",
"products": [
{
"planId": "cd317d26-7b13-4ab2-a525-653807518aba",
"period": {
"unit": "YEARS",
"duration": 1
},
"resources": [
{
"resourceId": "dc262ad3-4b6f-48b3-8568-acb8e9e842aa",
"amount": 10
}
],
"parameters": [
{
"aps": {
"type": "http://aps-standard.org/inhouse-products/tenant/1.1"
},
"activationParams": [
{
"key": "action_type",
"value": "purchase"
},
{
"key": "three_years_commitment",
"value": "true"
},
{
"key": "three_years_minimum_licenses",
"value": "10"
},
{
"key": "flex_discounts_selected",
"structured_value": {
"65331444CA": ["3YC_NEW_COMMIT_PROMO_2026"]
}
}
]
}
]
}
]
}