After installation, every voucher series in the OXID Admin gains four additional detail tabs. Navigate to Admin > Shop Settings > Vouchers, open or create a voucher series, and you will find the following tabs alongside the standard OXID tabs.
This is the main configuration tab (VoucherRulesMain). It covers:
Payment Restrictions
A multi-select list of all active payment methods in the shop. Selecting one or more methods restricts the voucher to those methods only. Leaving the list empty means all payment methods are permitted (whitelist semantics: empty = no restriction).
Delivery Restrictions
Identical semantics to payment restrictions, but applied to shipping methods. Selecting specific methods means the voucher is only valid when one of those shipping methods is active in the basket.
First Order Only
A single checkbox. When enabled, the voucher is only accepted if the currently logged-in customer has placed zero previous orders. Guest checkouts count as a first order.
Max Combined Vouchers
An integer field (0–99). When set to a value greater than zero, it caps the total number of vouchers that can be active in a single basket at the same time. A value of 0 disables this restriction.
The VoucherRulesTimeWindow tab allows you to define one or more time windows during which the voucher is valid.
Each time window entry consists of:
HH:MM formatHH:MM formatMultiple time windows per voucher series are supported. The voucher is valid if the current server time falls within any active time window. You can add, edit, and delete individual windows from this tab.
Time validation uses the server's local time. Ensure your server timezone matches the timezone your marketing team works with.
The VoucherRulesCombination tab manages the explicit combination blacklist.
Each blacklist entry is a pair of voucher series IDs that may not be used together in the same order. Pairs are stored canonically (A < B) to prevent duplicate entries.
Use cases:
The tab shows a table of all current blacklist pairs with a delete button per row, and an "Add pair" form at the bottom.
The VoucherRulesPaymentMinVal tab provides payment-specific and delivery-specific minimum order values — separate from the standard OXID minimum order value on the voucher series.
Payment-specific MOV
A table with one row per payment method. Enter a minimum basket value (net or gross, matching your shop's pricing mode) that must be reached for the voucher to be valid when that payment method is selected.
Delivery-specific MOV
Same structure, but keyed by shipping method instead.
These thresholds are checked after the customer selects their payment/delivery method. If the basket value is below the threshold, the voucher is rejected with a clear error message.
Scenario: Marketing wants to issue a 15% voucher (PAYPAL15) that is only valid when the customer checks out via PayPal.
Configuration:
PAYPAL15 in Admin.Customer journey:
PAYPAL15.Scenario: Flash sale — 20% off on Monday mornings between 08:00 and 10:00.
Configuration:
08:00, End Time: 10:00.Behavior:
Scenario: You have two voucher series — "WELCOME20" (20% for new customers) and "SUMMER30" (30% summer sale). You want to prevent customers from stacking both.
Configuration:
Behavior:
SUMMER30 after already having WELCOME20 active.SUMMER30 with an error message.WELCOME20 first would allow SUMMER30 to be applied.