Skip to content

Validate Voucher

POST /vouchers/{code}/validate query bearer

Validates a voucher code, returning its current balance, expiry and applicable constraints.


Overview

ID validate-voucher-api
Method POST
Path /vouchers/{code}/validate
Classification query
Domain promotion
Capability voucher-management
Service validate-voucher
Application promotion-engine — Promotion Engine
Auth bearer

Response

Business Object voucher
Description Value or benefit instrument issued, validated, redeemed, or cancelled.
Lifecycle issued → validated → partially-redeemed → redeemed → expired → cancelled

Scenarios using voucher-management

Scenario Description
Voucher Redemption Customer redeems a voucher or gift card during checkout in store or online. The flow covers voucher
API Method Path Type
Evaluate Promotions POST /promotions/evaluate command