Initiates the coupon voiding process with validation, event publishing, and asynchronous processing. Validates coupon existence and void eligibility before starting the void workflow. Publishes domain events for saga coordination and audit trail maintenance without immediate coupon modification. Voiding a coupon cancels it permanently, making it unusable for redemption while preserving audit history.
This endpoint allows to start the coupon voiding process. Voiding differs from redemption as it cancels the coupon without providing value to the customer, typically used for administrative corrections or fraud prevention. Please check Genocs.Fiscanner.WebApi.Controllers.VoidCouponRequest for request details.
This endpoint initiates void processing but does not immediately modify the coupon entity. Validates that the coupon exists and is not already redeemed before accepting the void request. Publishes VoucherVoidRequested domain event for downstream saga processing and business rule validation. The actual voiding business logic is handled asynchronously by saga orchestration. Supports reason tracking for audit purposes and compliance requirements through reason parameter. Returns the current coupon state without modifications - actual status changes occur through event processing. Voided coupons cannot be redeemed and are permanently marked as cancelled in the system.