Redeem bulk coupons

Lets you redeem one or more coupons of a customer.

👍

Notes

A maximum of 100 coupons can be redeemed in a single API request.

🚧

Warning

Bulk coupon redemption will fail if even one of the coupons is invalid. For example, if you submit a request with 100 coupons and just one is either invalid or not issued to the user, the entire redemption will be unsuccessful. There is no option for partial success in bulk redemptions.

Request Body parameter

ParameterDescription
redemptionRequestListList of coupons to redeem.
codeCoupon code to redeem.
redemptionTimeDate and time of redemption in YYYY-MM-DD HH:MM:SS format. The time defined here is used for certain evaluations, but it is not stored in the system. The system considers the store's current time as the redemption time.
transactionNumberTransaction number for which the coupon(s) needs to be redeemed.
billAmountTransaction amount for which the coupon is redeemed.
userDetails of the customer that redeems the coupon(s).
idUnique ID of the customer.
mobile*Unique mobile number of the customer.
email*Unique email ID of the customer.
externalId*Unique external ID of the customer.

*Any one of the customer identifiers is mandatory.

Response body parameter

ParameterDescription
entityIdUnique identifier for the entity.
result.idUnique ID of the result.
result.currencyInputIndicates if currency input is present.
result.localToBaseCurrencyExchangeRateExchange rate from local currency to base currency.
result.codeCode associated with the result.
result.discountCodeCode indicating the type of discount.
result.seriesCodeCode associated with the series.
result.isAbsoluteIndicates if the value is absolute.
result.couponValueValue of the coupon.
result.redemptionStatus.statusCodeStatus code object containing status details.
result.redemptionStatus.messageMessage indicating the status of coupon processing.
result.redemptionStatus.codeCode indicating the status of coupon processing.
result.redemptionStatus.successIndicates if the coupon processing was successful.
result.discountTypeType of discount provided.
result.discountValueValue of the discount provided.
result.discountUptoMaximum value up to which the discount is applicable.
totalCountTotal count of items in the response.
failureCountCount of items that failed.
Language
URL
Click Try It! to start a request and see the response here!