API Reference

Initiates the voucher redemption process with validation and state management.

Redemption Workflow: The redemption process follows these steps: Validate the voucher exists and is activeCheck redemption eligibility (not already redeemed, not expired)Mark voucher as "booking" to prevent concurrent redemptionPublish redemption event for downstream processingReturn acceptance confirmation Concurrency Control: The system implements optimistic concurrency control by immediately updating the voucher status to "booking" upon redemption request. This prevents double-spending scenarios in high-concurrency environments.

Event-Driven Processing: The actual redemption processing occurs asynchronously through domain events. This allows for complex business logic, external service integration, and proper error handling without blocking the API response.

Validation Rules:Voucher must exist in the systemVoucher cannot be already redeemedVoucher must not be expired or voidedOperator must have appropriate permissions

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!