Check and Update Coupon Usage
Update coupon usage tracking through the coupon provider.
Overview
The Check and Update Coupon Usage step updates coupon usage counters through the configured coupon provider. This tracks how many times a coupon has been used for usage limits.
Identifier
| Property | Value |
|---|---|
| Key | CheckAndUpdateCouponUsage |
| Group | Payments |
| Applicable Statuses | New |
Configuration Properties
This step has no configurable properties.
Behavior
What It Does
- Increments coupon usage counters
- Updates both internal Omnium tracking and external providers
- Handles usage limit enforcement
Prerequisites
- Order must have coupons applied
- Coupon provider must be configured
Side Effects
- Increments coupon usage counter
- May prevent future use if limit reached
- This step is invisible (doesn't show in workflow history)
Business Cases
When to Use
- Usage limits: Track "first 100 uses" type promotions
- Campaign tracking: Monitor coupon usage across orders
- Fraud prevention: Enforce maximum usage per coupon
Example Scenarios
Scenario 1: Standard Update Order uses coupon "SAVE10". Step increments the usage counter from 45 to 46.
Scenario 2: Near Limit Coupon has 100-use limit and is at 99 uses. After this order, it's at 100 and future orders can't use it.
Error Handling
| Condition | Result | Continues Workflow? |
|---|---|---|
| Update successful | Success (invisible) | Yes |
| Update failed | Error | Yes (doesn't cancel) |
Related Steps
- Check Personal Discount Coupons - Validates personal coupons
- Try Redeem Personal Discount Coupons - Redeems personal coupons