Contents
On this page
- No voucher was created after a purchase
- The voucher email did not arrive
- A code is refused at checkout
- The balance looks wrong
- Unpaid holds are never released
- The PDF link says “Voucher not found.”
- The PDF shows {something} instead of a value
- My Account > Vouchers shows a 404
- Notices in wp-admin
- A staff member cannot open the plugin
- Still stuck?
Troubleshooting - Plugixa PDF Vouchers for WooCommerce
Most problems show their cause somewhere in the plugin: in the order notes, in a voucher’s Emails list or in its History. Start there.
No voucher was created after a purchase
- Check the order status. Vouchers are created when the order reaches the status set in Create vouchers when the order is (Settings). With Completed, a Processing order has no voucher yet. Bank transfer and cash orders stay On hold or Pending payment until you change them.
- Check the product. Sell as a voucher must be ticked on its PDF Voucher tab, see Voucher products. The setting only applies to orders placed after you ticked it.
- Read the order notes. A successful run adds Voucher issued: (or Vouchers issued:) with the masked codes. A failure adds A voucher could not be created: with the reason.
- Refunded units never get a voucher.
The voucher email did not arrive
Open the voucher and look at Emails, see Voucher details and history:
| What it shows | What to do |
|---|---|
| Sent | WordPress handed the email to your mail system. Ask the customer to check spam. Test your site’s mail with an SMTP plugin. |
| Failed with an error | The error comes from your mail system. Fix your mail setup, then click Resend email. |
| Skipped: the gift voucher email is turned off | Switch on Gift voucher in WooCommerce > Settings > Emails. |
| Skipped: No email address on the voucher. | Open the PDF with View PDF on the voucher and send it yourself. |
| Not sent yet. | The voucher was created by hand without Email the voucher to the recipient now, or (Pro) it is scheduled for a later day. |
Customers can also ask for their vouchers again from the Balance check (Didn’t receive your voucher?).
A code is refused at checkout
The message says why. See the full list in Checkout and redemption. The most common causes:
- A voucher cannot be used to buy another voucher.: the cart holds only voucher products.
- This voucher cannot be used for the products in your cart.: a product voucher, with none of its products in the cart.
- This voucher is not active yet.: a pending voucher (with Pro, a physical card that has not shipped).
- WooCommerce’s own “does not exist” coupon message: a typo, a code from another site, or the visitor was locked after 10 wrong codes within 15 minutes. The lock lasts 30 minutes. Staff who can redeem vouchers are never locked.
- This voucher can only be used when paying in (a currency): the voucher was sold in another currency than the one the shop is showing.
The balance looks wrong
Open the voucher and read its History. Every change of the balance is a line with its date, order or note, and the balance after it. A Held at checkout line means an order is waiting for payment: the amount comes back by itself if the order is not paid within Release unpaid holds after (minutes), or straight away when it fails or is cancelled. Orders on hold (bank transfers) keep their hold until they are paid or cancelled.
Unpaid holds are never released
Releasing old holds and expiring vouchers runs on WP-Cron (every hour and every day). On a site
with few visitors, or with DISABLE_WP_CRON set, set up a real cron job that calls
wp-cron.php, as WordPress recommends.
The PDF link says “Voucher not found.”
Links in emails work for 180 days, and stop working when the voucher’s code changes. Send a fresh link with Resend email, or let the customer download the PDF from My Account, where links are made fresh on each visit.
The PDF shows {something} instead of a value
A placeholder that does not exist prints as written. Open the design: the editor lists unknown placeholders. See PDF designs.
My Account > Vouchers shows a 404
Go to Settings > Permalinks and click Save Changes once.
Notices in wp-admin
| Notice | Meaning |
|---|---|
| Plugixa PDF Vouchers needs WooCommerce. Install and activate WooCommerce to sell vouchers. | WooCommerce is not active. |
| Plugixa PDF Vouchers could not finish setting up its database. | The database tables could not be created. The notice shows what the database said, usually that the database user may not create tables or the disk is full. Ask your host, then click Try again. |
| Two copies of Plugixa PDF Vouchers are active | The free and the Pro build are both active. Only one runs. Deactivate the one you no longer need: vouchers are shared and stay as they are. |
| Plugixa PDF Vouchers: dependencies are missing. | The plugin files are incomplete. Download the plugin again and reinstall it. |
A staff member cannot open the plugin
Out of the box only administrators and shop managers have access. Other users need the voucher capabilities. See Staff access.
Still stuck?
Collect the order number, the voucher code and what the voucher’s History and Emails show, and contact Plugixa support.
Quick Links
Share