Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt

Use this file to discover all available pages before exploring further.

Open a voucher’s detail view to see how it’s used and managed.” The detailed view of a voucher shows its:
  • Details, like its parent campaign, voucher owner, and info specific to the voucher type.
  • Voucherify ID.
  • Barcode and QR code.
  • Redemption overview.
From the detailed view, you can go to other tabs to track voucher usage, check any failures, and use the data to debug errors.

Find vouchers

Use the Vouchers view to browse and search all voucher types in one place. Go to Campaign Hub > Campaigns > Vouchers to see all your codes, including:
  • Discount coupons
  • Gift cards
  • Referral codes
  • Loyalty cards
Use filters to narrow down the list of vouchers based on selected criteria. You can also use Search codes on the left bar to find a voucher by its code.

Use categories

Use Categories to organize vouchers and filter them faster. You can create a category when you create a campaign or add it later in the voucher details. To manage categories, go to Campaigns > Categories. Categories can also have a hierarchy. The lower the number, the higher the category priority in stacking rules.

Redemptions and validations

The Redemptions and Validations tabs list successful and unsuccessful redemption and validation attempts. Add filter to narrow down results. Click on ID to learn more about the event, access its log, and request and response payloads. You can also export redemption data to a CSV file.
Validation data is stored for 30 days.Logs are stored for a limited time:
  • Shared clusters: 6 months
  • Dedicated clusters: 12 months

Voucher activity

The Activity tab lists all events related to the voucher, like creation, updates, or deactivation. Add filter to narrow down results. Click Log to learn more about the event, see related events, and request and response payloads.
Solving issues with vouchersThe Activity tab in voucher details is a great tool for solving issues you have with voucher configuration, validation, and redemption. The events listed contain all data regarding changes to the campaign as well as the API request and response payloads of those changes.

Track gift and loyalty card transactions

In the detailed view of a gift or loyalty card, use the Transactions tab to monitor balance changes. The Transactions tab lists:
  • Transaction type: For example, point or credit redemption.
  • Balance: Current number of points or credits
  • Creation date: When the transaction occurred.
  • Transaction details (+ button), which show the transaction in a JSON format.

Export for data tracking

Use exports to download voucher and transaction data for reporting. The export tool looks similar for all exports.
1

Select attributes

Choose which standard fields and custom attributes (metadata) to include in the exported CSV.The date and times of the exported data are in the UTC time zone.
2

Export

Once ready, Export your list. The file will be generated and delivered to your Notifications Center.You can also find all your exported files in Audit log > Exports.
Larger exports may take longer to generate.

Export vouchers

Export voucher data to review or analyze voucher usage. To export all or filtered vouchers:
  1. Go to Vouchers.
  2. Apply filters (optional).
  3. Click Manage filtered vouchers.
  4. Click Export filtered vouchers.
You can also export vouchers by going to a campaign and clicking the three-dot menu > Export to CSV. This exports all vouchers, even if filters are applied.

Export transactions

Export transactions directly from the Transactions tab. Click Export, then choose which fields to include in the CSV file.
You can export the following fields for gift card transactions:
  • ID: Unique Voucherify transaction ID.
  • Type: Type of the transaction, for example CREDITS_ADDITION.
  • Source ID: Optional source ID of the transaction.
  • Reason: Optional reason added to the transaction.
  • Balance: The number of available credits after the transaction.
  • Amount: The number of credits added or subtracted in the transaction.
  • Creation date: The date and time when the transaction was created (in UTC time zone).
  • Voucher ID: Unique Voucherify ID of the gift card.
  • Campaign ID: Unique Voucherify ID of the parent campaign.
  • Source: The origin of the transaction, for example Voucherify web UI.
  • Details: JSON payload of the transaction details.
You can export the following fields for loyalty card transactions:
  • ID: Unique Voucherify transaction ID.
  • Type: Type of the transaction, for example POINTS_ACCRUAL.
  • Source ID: Optional source ID of the transaction.
  • Reason: Optional reason added to the transaction.
  • Balance: The number of available points after the transaction.
  • Amount: The number of points added or subtracted in the transaction.
  • Creation date: The date and time when the transaction was created (in UTC time zone).
  • Voucher ID: Unique Voucherify ID of the loyalty card.
  • Campaign ID: Unique Voucherify ID of the parent campaign.
  • Source: The origin of the transaction, for example Voucherify web UI.
  • Details: JSON payload of the transaction details.
  • Related transaction ID: Unique Voucherify transaction ID related to a receiver/donor card when points were transferred from/to another card.

Export redemptions

You can export redemptions from the main Redemptions tab or from a selected campaign. Use filters to narrow down the results.
To export redemptions for a specific voucher or vouchers, use the Voucher code filter.
Learn more about features related to voucher tracking.
For campaign performance and analytics, see Campaign tracking.
Categories can be used to organize vouchers and campaigns, but they are primarily used for stacking rules.Stacking rules define how incentives like vouchers behave when they’re redeemed together. Stacking rules can influence the order of application, which incentives can be used exclusively, how discounts are calculated together, and many other details.Learn more about stacking rules and categories.
Track voucher activity programmatically with the Voucherify API. Use these endpoints to inspect redemptions, validations, gift card and loyalty card transactions.Redemptions:Gift card and loyalty card transactions:Exports:
  • Use the Exports API to generate CSV exports of vouchers, redemptions, and transactions.
Last modified on May 8, 2026