The new commerce experiences for license-based services include many new capabilities and are available to all Cloud Solution Provider (CSPs). For more information, see new commerce experiences overview.
Parters can verify whether a customer transaction is eligible for a given promotion. This method returns True if the customer transaction is eligible for a given promotion. Partners can verify eligibility before submitting a transaction to ensure the promotion will be applied.
Prerequisites
Credentials as described in Partner Center authentication. This scenario supports authentication with both standalone App and App+User credentials.
Eligibility includes the product sku availability purchased, the promotion ID being evaluated, the quantity, term duration, and billing cycle of the transaction.
The throttling rate for this API a maximum of 625 requests per minute (RPM) per partner tenant. Calls that exceed the limit will result in the http response of 429. See throttling guidance for information on throttling.
POSThttps://api.partnercenter.microsoft.com/v1/customers/46632f71-f052-4384-8f84-4cdb6c12c2a1/promotionEligibilities HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70b
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
X-Locale: en-US
// Request example with no promotion ID input
{
"items": [
{
"id": "0",
"catalogItemId": "CFQ7TTC0HBSJ:0001:CFQ7TTC0JQH3",
"quantity": 300,
"termDuration": "P1M",
"billingCycle": "monthly"
}
]
}
REST response
If a promotionId is provided and the request is successful, this method returns a collection of eligibility results. If promotionId isn't provided and the request is successful, this method returns all promotions available for the offer specified and the corresponding customer eligibility for each promotion.
Response success and error codes
Each response comes with an HTTP status code that indicates success or failure and more debugging information. Use a network trace tool to read this code, error type, and more parameters. For the full list, see Error Codes.
Eligibility error types and descriptions
Eligibility will return false if the eligibility checks determine the product SKU being evaluated against the promotion ID don't align. Various conditions and constraints are evaluated and return error types to describe the conditions not met for the eligibility.
Eligibility error type
Eligibility error description
InvalidCatalogItemId
The provided CatalogItemId is invalid.
InvalidPromotion
The provided promotion is invalid.
PrerequisiteProductOwnership
The customer doesn't meet the prerequisite product ownership requirements to be eligible for this promotion.
RedemptionLimit
The redemption limit for this promotion has been met.
SeatCount
The provided quantity doesn't satisfy the minimum or maximum seat requirements for the promotion.
OfferPurchasedPreviously
This offer has been purchased previously for this customer.
Term
The provided term isn't applicable for the promotion.
The Microsoft commercial marketplace is a catalog of cloud applications and services that contains offerings from Microsoft and thousands of partners. In this learning path, you'll be introduced to concepts that will help your organization get ready to sell your cloud products and services through the commercial marketplace.