Stackable Discounts API enables you to validate and redeem up to 5 objects in a single request. You can use coupons, gift cards, promotion tiers, loyalty, and referral codes. In the redemption request, you need to provide a list of redeemables that define redeemed/validated objects.
The workflow | API Endpoint |
---|---|
VALIDATION Validation checks if all redeemables provided in the request can be applied in the given context (checks customer and order details against validation rules and other attached limits). Only if all redeemables can be applied, the validation returns valid: true. | POST https://URL/v1/validations for server-side POST https://URL/client/v1/validations for client-side |
REDEMPTION You can pass up to 5 redeemables that will be redeemed during the request. Only if all redeemables can be applied (each redeemable is validated before the redemption), the redemption is successful. | POST https://URL/v1/redemptions for server-side POST https://URL/client/v1/redemptions for client-side |
ROLLBACK In the case of unwanted redemption, you can roll it back. Note that if you call this endpoint, all applied discounts will be rolled back too. There is no way to roll back a redemption of a single redeemable. | POST https://URL/v1/redemptions/parent_redemption_id/rollbacks |