Redemptions
The Redemptions section in the Dashboard consists of four tabs: Redemptions, Validations, Sessions, and Stacking Rules. The Redemptions tab lists every redemption attempt of any code created within Voucherify. Its goal is to help you track what happens to your codes. Thanks to the filter panel and export tool, you can analyze and draw insights from redemption data.
Contents
Redemptions
Each redemption attempt, whether successful, rolled back, or failed, is saved in Voucherify. To get a list of redemptions, head to the Redemptions tab in the Campaign Hub section.
Filters
- Status
- Code
- Creation date
- Voucher code
- User who redeemed the voucher (available only for Administrator)
- Campaign
- Customer
- Metadata (custom attributes)
Click the Save button to create a search query.
Redemption details
The basic view contains:
- Status
- Type
- ID
- Campaign
- Incentive
- Customer
- Creation date
You can click on any redemption to display all the details. Depending on the campaign the voucher comes from, the details view can additionally include:
- Order summary
- Customer details
You can also access the redemption details by going to the voucher details and the Redemptions history tab in the Vouchers section of the dashboard.
Failed redemptions
Because Voucherify supports complex coupon validation rules, the redemption can fail for multiple reasons. Click on the ID of a failed redemption attempt to see the failure code and failure message. The following list shows all of the failure messages:
- Voucher did not exist
- Voucher was not active yet
- Voucher expired
- Voucher was disabled
- Redemption quantity exceeded
- Gift voucher amount exceeded
- Order does not match validation rules
- Customer does not match to the segment
- Redemption conditions not met
- Order was specified incorrectly
- Order amount was specified incorrectly
- Order amount was not specified
- Order items were not specified
- Customer was not specified
- Invalid input data
Remember 💡
Successful redemptions can be reversed with the process called “Rollback”. You can rollback each redemption using the API or with the Rollback button in the redemption details screen. Note, however, that you can roll back a redemption up to 3 months back.
Detailed logs
If you want more information about the voucher's history, go to the detailed view of the redemption and the Events section.
- Id
- Type
- Occurrence date
- Log ID
- Channel
- Event data
- HTTP method
- Related Events
- Request Body
- Response Body
- Query Parameters
You can also access this view by going to the Audit Log section and clicking the relevant log id.
Data export
You can download a CSV file with redemptions data. You can apply filters and browse data you are interested in, or you can download the complete redemptions history.
In the Redemptions tab, click the export tool button to open the export manager.
You can choose which redemption details to include in your CSV file from Redemption attributes and Custom attributes (metadata).
Click the Export button.
When the CSV file is ready to download, it will appear in your notifications center. Click the notification to download the file.
Validations
This tab shows the complete overview of successful voucher validations with the following details:
- Status
- Session key
- List of incentives sent in the validation
- List of inapplicable incentives
- List of skipped incentives
- Customer
- Creation time
You can narrow down the displayed results by selecting the Add filter button. Validations can be filtered by status, creation date, and incentives.
Validation data is stored for 30 days.
Further details about the validation, e.g. the request and response bodies, can be found in the Audit Logs:
- Go to Audit Logs dashboard section in the left panel.
- Create and apply the filter with the timeframe when the validation occurred. Note that the filter date and time are given in the project time.
- Search for the validation (URL with a
v1/validations
value) in question by looking for the date and time. The date and time is in the UTC time – recalculate the equivalent UTC time of your validation. - Click on the log to view the details.
You can also see validation history by going to voucher details. Voucher validation history lists all successful validations from the last 30 days.
Sessions
Stacking rules
Stacking rules are a collection of conditions that change the behavior of the Validation and Redemption of Voucherify’s promotion tiers and vouchers. These conditions allow you to define how different campaigns affect each other when the customer is redeeming multiple redeemables. For a more in-depth description, read the Stacking Rules article.