PAY by Square QR Payments in WooCommerce: Free Setup
A payment QR code helps customers pre-fill a bank transfer without having to manually enter the information. This guide shows you how to set up the free plugin MakeMeHappy QR Code: from the bank account to the QR code verification after the order is placed and in the optional customer email.
Start on the page PAY by Square QR Payment for WooCommerce or a plugin Download it for free from WordPress.org. No purchase or license activation is required. The procedure corresponds to version 1.1.0; item names are also listed in English for the interface without a language pack.
Quick Navigation
- What QR Payments Do and Don't Do
- Pre-installation Requirements
- Plugin installation
- Bank Account in WooCommerce
- QR Code and Email Settings
- Safe Test of Pre-filled Data
- Solution for a QR Code That Isn't Displayed
What is PAY by Square, and what does the plugin do?
PAY by square is a QR payment format used for bank transfers. Once scanned in a supported banking app, the payment details are pre-filled. The customer must verify the recipient and other details and confirm the payment themselves. Check for support of this format in the specific banking app.
The plugin does not send payments, confirm receipt of funds, or automatically reconcile bank statements. It helps you prepare the transfer details; you verify the payment using your usual procedure. The fact that the plugin is free does not mean that the bank account or the transfer itself is free of bank fees.
What you need
- WordPress 6.0 or later, PHP 7.4 or later, and an active WooCommerce installation.
- On Direct bank transfer (BACS) with a bank account on file.
- For PAY by Square, a valid Slovak IBAN beginning with SK and the order in EUR.
- A banking app that supports the selected QR format.
Before updating an existing plugin, create a backup of your website. Do not delete an older paid or standalone version just because of these instructions; first, check the migration process described on the plugin’s page.
1. Install MakeMeHappy QR Code
- In WordPress, open Plugins → Add New Plugin.
- Search MakeMeHappy QR Code and check the plugin's name and author.
- Click on Install Now and then Activate.
Alternatively, use the ZIP file from the plugin's official page on WordPress.org through Upload a plugin. In this edition, you do not need to enter a registration number or license key.
2. Set up a bank account in WooCommerce
Open WooCommerce → Settings → Payments → Direct Bank Transfer. Enable the payment method and enter the correct recipient information in the bank account fields. The IBAN must be in a valid format and include a check digit. The BIC is optional; if you enter it, it must be in the correct format. Save your changes.
The QR plugin uses existing bank accounts from WooCommerce. In the QR settings, you don't need to enter the IBAN again—just select a saved account. If you use more than one account, make sure the correct one is selected.
3. Open the "QR Payment" tab and configure the output
Go to WooCommerce → Settings → QR Payment. In the Slovak translation, the card may be titled QR payment. Check the following options:
- Enable QR payment: QR main switch. It is enabled by default in a new installation; when updating, check the saved settings.
- Bank account: account from WooCommerce banking information.
- QR code format: For Slovak IBANs and EUR, select "PAY by square." Additional formats are SPAYD and SEPA EPC; SEPA EPC requires EUR. Please check availability in your banking app.
- Variable symbol (VS): An optional symbol derived from the order number for PAY by square and SPAYD. It uses the first 10 digits at most; non-numeric characters are removed. The SEPA EPC format does not use this option.
- Payment message: Message to the recipient with variables
{order_number}a{site}. Do not include the customer's personal information in the message. - QR code size (px): Image size: 64, 128, 256, or 512 pixels; the default size is 256 px.
- Customer emails: A separate option for QR codes in customer HTML emails. It is turned off by default.
After making your changes, click Save changes. If an error occurs, the plugin will not automatically select a different bank account or a different QR format.
Read the information about external services
The PAY by square image is generated by the Profit365 service; the SPAYD and SEPA EPC formats use QR Server. When the image is loaded, the browser or email proxy contacts the service and transmits payment details—such as the IBAN, amount, currency, message, and any variable symbol—along with standard request data, including the IP address.
Details can be found in the settings information box and in Description of external services on WordPress.org. The plugin does not require a separate API account for these services. Closing the information box will not disable QR payments; to stop new transactions, turn off the main switch Enable QR payments.
Where the QR code appears to the customer
A QR code is added to the order confirmation page when an unpaid order with a positive balance, a BACS payment, and a status of "Pending Payment" or "Suspended" (pending or on hold). The page must be opened with authorized access to the order in question.
If you turn on Customer Emails, The QR code may also appear in a customer HTML email under the same conditions. It is not included in administrative or plain-text emails. The new output will not appear for paid, completed, canceled, failed, or refunded orders, nor for orders using a different payment method.
The email sent is static: Once an order has been changed or paid for, the QR code in an email that has already been sent cannot be modified or revoked.
4. Review the pre-filled information without submitting the payment
- Ideally, create your own order with a positive amount and payment in the test store by bank transfer.
- Check its unpaid status and open the order confirmation page.
- Scan the QR code in your banking app. Check the recipient's IBAN, the amount, the currency, the variable symbol, and the message.
- Do not confirm the payment just for the sake of testing. You do not need to send money to verify the pre-filled information.
- If you have enabled emails, check your custom HTML email and allow remote images to load if your email client is blocking them.
The QR code isn't displaying: what to check
- It is turned on Enable QR payments and the saved settings?
- Is the correct bank account and a valid IBAN selected? If applicable, is the BIC entered in the correct format?
- Do the account format and currency match? PAY by Square requires an SK IBAN and EUR; SEPA EPC requires EUR.
- My order has a BACS payment, a positive balance, and a status
pendingoron hold? - Is it turned on for emails? Customer Emails And is this a customer HTML email?
- Is an external image being blocked by a browser, email client, or proxy? Is the service that generates the image available?
Do not attempt to retrieve the QR code by changing an actual paid order back to an unpaid status. Use a test order for troubleshooting. The standard text instructions for bank transfers in WooCommerce remain available to the customer even without the QR image.
A QR bank transfer is not a payment gateway
QR pre-fills the bank transfer information here; it does not replace card payment processing or automatic payment confirmation from the payment gateway. Bank fees depend on your bank and account. If you’re also handling invoicing, this is a separate integration—see Guide to Faktury-online.com and Fakturyweb.cz for WooCommerce.
Download the plugin and get further assistance
- Overview of Features for the PAY by Square QR Payment Plugin for WooCommerce
- Download MakeMeHappy QR Code for free from WordPress.org
- Contact Us if You Have Problems with the Settings
When requesting assistance, please specify the plugin version, the selected format, the menu, and the status of your test order. Do not disclose the order's secret key, customer information, or screenshots containing sensitive data.