Initiates the coupon redemption process with validation, event publishing, and asynchronous processing.
Validates coupon existence and redemption eligibility before starting the redemption workflow.
Publishes domain events for saga coordination and audit trail maintenance without immediate coupon modification.
This endpoint allows to start the coupon redemption process. Please check Genocs.Fiscanner.WebApi.Controllers.RedeemCouponRequest for request details.
This endpoint initiates redemption processing but does not immediately modify the coupon entity.
Validates that the coupon exists and is not already redeemed before accepting the redemption request.
Publishes CouponRedemptionRequested domain event for downstream saga processing and business rule validation.
The actual redemption business logic is handled asynchronously by saga orchestration.
Supports device tracking for audit purposes and fraud detection through deviceId parameter.
Returns the current coupon state without modifications - actual status changes occur through event processing.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Request rejected due to coupon already redeemed or invalid request parameters.
Authentication failed - valid JWT token required for redemption operations.
Coupon with specified ID does not exist in the system.