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.