Rejected Redemptions Messages

A list of reasons for rejecting the voucher transaction

🚧

Make sure to check Errors page before proceeding!

When the redemption of the voucher is unsuccessful and you receive a 422 error, regardless of whether you perform a Create a Redemption or Validate the Voucher request, we add a message that will help you to find out why the conditions weren't fulfilled and redemption of the voucher rejected.

There may be various reasons why a voucher redemption request is denied, related to:

VOUCHER CODE AND ITS RESTRICTIONS:

MessageDescription
Voucher is expiredthe voucher used in the redemption request is not valid anymore
Voucher is not activethe voucher used in the redemption request is not active
Max redemptions limit for voucher reachedthe number of redemptions set for the voucher has been fulfilled
Max budget limit for voucher reachedthe maximum budget spent for this voucher code has been reached
Voucher has been already used or it is temporarily blocked. No redemptions leftthis voucher has been redeemed or is reserved for another transaction, and doesn't have any more redemptions left
Voucher assigned to different customerthe voucher is assigned to another Customer ID, and only that Customer ID can redeem it

CAMPAIGN ASSOCIATED WITH THE VOUCHER AND ITS RESTRICTIONS:

MessageDescription
Campaign is finishedthe promotional campaign associated with the voucher code has ended.
Campaign is not activethe promotional campaign associated with the voucher code has been inactivated
Parent campaign not foundthe main campaign of the voucher's promotion is missing
max redemptions limit reachedthe campaign has already reached the maximum number of redemptions set for this promotion
max budget limit reachedthe promotion's maximum budget has already been reached by the campaign.

PROMOTION RULES AND RESTRICTIONS:

MessageDescription
time of order rule wasn't satisfiedthis means there is a rule that requires the transaction to be performed within a certain time frame (for instance, during lunchtime), and that timeframe wasn't met
timeframe rule wasn't satisfiedthe rule that specifies when the campaign starts and when it ends wasn't fulfilled (for instance, the campaign hasn't started yet)
Order value is lower than the required minimum value for the campaignthe minimum order value set for this promotion hasn't been reached
Additional categories rule wasn't satisfiedthere are additional categories (related to the transaction) set for this campaign that weren't satisfied or are missing
Missing products items and null total transaction costwe require either the total transaction cost or the price of each product in the product items to calculate the discount, in this case, both are missing
no products satisfy product category rulethe transaction does not contain any product categories that meet the requirements for the promotion to be valid, or there may be missing product information.
product items rule wasn't satisfiedthe transaction does not contain any products that meet the requirements for the promotion to be valid, or there may be missing product information.
basket items rule wasn't satisfiedthe transaction does not contain any basket items, that are required to be included in the purchase transaction for the promotion to be valid (eg. Buy 2, get 1 Free) or there may be missing product information.

CUSTOMER-RELATED RULES:

MessageDescription
Customer categories rule wasn't satisfiedthe promotion is restricted to a specific Customer segment and the Customer ID passed in the request is not included in that segment
Customer max redemptions rule wasn't satisfiedthe Customer has redeemed this particular promotion already and is not eligible for additional redemptions (regardless of whether it's a unique or generic voucher)
Customer loyalty points rule wasn't satisfiedthe promotion is restricted to Customers with a specific number of minimum loyalty points and the points allocated for the Customer ID passed in the request did not meet this criteria

GENERAL:

MessageDescription
Total transaction cost is not equal to the sum of products costthere is a discrepancy in the request information that has to be solved before proceeding
unknown rulean unknown rule has been created for the campaign an

Here are the codes in the text file:

Missing products items and null total transaction cost
Voucher is expired
Voucher has been used yet or it is temporarily blocked. No redemptions left
Voucher assigned to different customer
Voucher is not active
Order value is lower than the required minimum value for the campaign
Total transaction cost is not equal to the sum of products cost
Campaign is finished
Campaign is not active
Parent campaign not found
max redemptions limit reached
max budget limit reached
max redemptions limit for voucher reached
max budget limit for voucher reached
Additional categories rule wasn't satisfied
Customer categories rule wasn't satisfied
Customer max redemptions rule wasn't satisfied
Customer loyalty points rule wasn't satisfied
no products satisfy product category rule
product items rule wasn't satisfied
basket items rule wasn't satisfied
time of order rule wasn't satisfied
timeframe rule wasn't satisfied
unknown rule