Troubleshooting

Logging

The module automatically logs errors when generating QR codes.

Viewing Logs in Administration

Logs are available directly in the WordPress administration:

WPify Woo → WPify Logs

Here you can:

• Select log by plugin and date
• View details of individual entries

Log Location on FTP

Logs are also stored on the server:

wp-content/uploads/logs/

What is Logged

Event	Description
QR generation error	Failure when creating QR code
Unsupported currency	Order currency does not match QR standard

Common Problems and Solutions

QR code is not displaying

Possible causes:

1. Module is not active

   • Check: WPify → WPify Woo
   • Enable the “QR Payment” module

2. Payment method is not configured

   • Go to module settings
   • Add a payment method and bank account

3. Position set to “Do not display”

   • Check the “QR position on thank you page” setting

4. Currency or country mismatch

   • QR code is displayed only if the currency and country match the account settings
   • Check “Enabled currencies” and “Enabled countries”

---

Error: Call to undefined function exec()

Cause: The server does not support the PHP exec() function needed for generating Slovak QR codes.

Solution:

1. Go to module settings
2. Enable “Compatibility mode”
3. Save changes

Note

Compatibility mode uses an external API for generating QR codes.

---

QR code is not displaying in emails

Possible causes:

1. Email types not selected

   • In the payment method settings, select emails in the “Show in emails” field

2. Plain text email

   • QR code is not displayed in text emails, only in HTML

3. Problem with base64 format

   • Enable “Save as image” in module settings

---

QR code cannot be read by some banking apps

Symptoms: The QR code displays correctly, but some banking apps report an error when reading it (e.g., “Could not find valid data”).

Possible causes and solutions:

1. Missing “Recipient name”

   • Some banks (e.g., AirBank) require the recipient name to be filled in, even though the CZ standard does not require it
   • In the account settings, fill in the “Recipient name” field (exact name of the account owner)

2. Wrong QR standard for the country

   • The CZ standard works only for Czech banks and CZK currency
   • If you have it set for multiple countries (SK, RO, …), these banks do not support the CZ standard
   • Solution: Use the “Auto detect by order” setting - the module automatically selects the correct standard based on the order country and currency

3. Test in another app

   • Different banking apps have different tolerance for QR format
   • Try reading the QR in another banking app to verify

Tip

For more information about QR standards and their limitations, read the article about QR payments (in Czech).

---

QR code is broken / not displaying correctly

Possible causes:

1. Invalid account data

   • Check the correctness of IBAN, account number
   • Check logs for error details

2. Incorrect QR standard

   • Verify that the QR type matches the currency:
     • CZ + CZK
     • SK + EUR
     • HU + HUF
     • EPC + EUR

3. Missing XZ utils for SK

   • Enable compatibility mode

---

Unsupported currency for QR standard

Error in log: QR payment: Unsupported currency for QR standard.

Cause: The order currency does not meet the QR standard requirements.

Solution:

• For CZ standard, the currency must be CZK
• For SK and EPC standards, the currency must be EUR
• For HU standard, the currency must be HUF

If you have multiple currencies, set up a separate account for each currency with the corresponding standard.

---

QR code is not generated for some orders

Check:

1. Order payment method

   • QR is displayed only for configured payment methods

2. Billing country

   • Check the “Enabled countries” setting for the account

3. Order currency

   • Check the “Enabled currencies” setting (for “Auto” type)

4. Filter wpify_woo_skip_qr_payment

   • Check if you have custom code that skips rendering

---

Email client warns about “external files”

Cause: Enabling QR saving as file causes the email to contain links to external images.

Solution: This is expected behavior for some email clients. Alternatively, you can disable “Save as image” and use base64 format.

---

QR code is not displaying in Gmail

Cause: Gmail blocks images embedded in base64 format directly in the email body by default.

Solution:

1. In the module settings, enable “Save as image”
2. The QR code will be saved as a physical file on the server and inserted into the email as a link to an external image
3. Gmail will then show a “Display images” prompt — after clicking, the QR code will be displayed

Note

Some email services may show a warning about external content when “Save as image” is enabled. This is standard behavior and cannot be bypassed.

---

Conflict with WebP Express plugin

Symptoms: The QR code is displayed in the email but not on the thank you page. The log may show an error like “File does not exist or is outside restricted basedir”.

Cause: The WebP Express plugin may interfere with loading images that are not standard WordPress attachments (e.g., generated QR codes).

Solution:

1. In the WebP Express plugin settings, enable “Convert on upload”
2. Alternatively, check the open_basedir setting on the server

---

Are QR code files filling up the disk?

QR codes are saved to wp-content/uploads/qr-payment/. Each order and account combination has one file. Files are not overwritten and remain on disk.

For regular cleaning of old files, you can set up a cron job or use a media management plugin.

Contact Support

If the problem persists, contact support at support@wpify.io.

Prepare this information:

• WordPress version
• WooCommerce version
• WPify Woo plugin version
• Log output (WPify Woo → WPify Logs)
• Optionally, fatal errors output from WooCommerce → Status → Logs