At the end of September 2022, the traditional inpayment slips (ISR) for bank transfers in Switzerland have disappeared. The replacement is the “QR bill” (https://www.einfach-zahlen.ch/), which was introduced in July 2020.
In order to offer this cost-effective payment option with all its advantages in the future, we have developed sqrip. sqrip for WooCommerce consists of a universal API (http://api.sqrip.ch/) and a WordPress plugin, which connects seamlessly with WooCommerce and comes up with various options. The plugin is “open source” (https://github.com/netmex/sqrip-woocommerce) and can thus be adapted for other store systems.
sqrip is listed as an additional payment method in WooCommerce and can be configured there. For identification and billing purposes, but also for security aspects, the plugin is connected to the sqrip account via an API key/token. The QR invoice is created by the API, delivered and saved in the desired format in the media library. From there, the file can be integrated in various places (e.g. as an insert in the confirmation email) and reopened at any time. If the invoice has been changed, the QR payment part can be updated with one click. The reference number is prominently displayed with the order so that reconciliation is quickly possible.
Good to know
- The invoice from WooCommerce is not touched. The QR invoice is a separate PDF document.
- The normal IBAN or the new QR-IBAN can be used as the recipient account. With a QR-IBAN, payments can only be executed with the specification of a QR reference (number). This allows each individual deposit to be uniquely assigned to a customer / order. Automatic matching of payments received with orders is thus possible. This is the basis for further (partial) automation.
- One sqrip account can be connected to multiple stores. Multiple API keys are possible.
- Each API key should be replaced after a self-selected duration. Therefore, it is possible to define an expiration date. After this date, QR Invoice can no longer be offered without adjustments from the store owner. A new API key must be created and linked.
sqrip offers several options:
a) Name and description of payment method
Name the payment method ‘Bank Transfer’ or ‘Deposit’ or whatever you want.
b) b) Payee
The payee is automatically taken from the sqrip account or the WooCommerce settings. A manual adjustment is possible.
The bank account to which the invoice amount should be transferred. If this account number is changed intentionally or unintentionally, the owner of the sqrip account will be informed of this change by e-mail. He can actively confirm the change or passively allow it.
d) (QR) reference number
The reference number is either created randomly or calculated on the basis of the order number. Inital 6 digits can be defined for easier identification. It automatically adapts to the IBAN format used.
e) additional information
On up to three lines additional information can be added to the QR invoice. This includes
– the due date (The time given to the payer to settle the invoice may be communicated as text on the payment part.).
– the order number (Be aware: sqrip not use the order# of the plugin “WoCommerce Sequential Order Numbers”)
– any additional text (e.g. URL of webshop, thank you message)
This fiels supports WPML.
Define the e-mail to which the qr-invoice will be attached to.
It can also be offered for download on the confirmation page.
If you generally need to adjust pricing or quantity after an order has been placed, you can suppress a QR invoice generation at the checkout and generate it manually later.
g) E-mail enclosure
The QR invoice can be enclosed with the e-mail in two ways:
– page A4 (blank) with payment section at the bottom
– only the payment section (formerly “payment slip”) in A6 format.
– The default language to be used on the QR invoice (de, fr, it, en) can be set per store.
– WPML is supported. For multilanguage sites, it’s possible to display the QR invoice in the language selected by the customer.
i) Test e-mail
With one click, you can test the settings and see how the QR invoice is received by your customers.
j) Add sqrip payment method manually
Add sqrip as payment method for manually created orders.
k) Use sqrip QR-Codes for Refunds
Scan the QR-Code with your Banking App to initiate refunds. Remember: IBAN of client required!
l) Manual payment comparison
Once an order has a defined order status you can confirm that the payment was done by the client and the status of the order can be changed to another status. If there is no suitable status available, you can create one in seconds. You can confirm the payments either on the list of orders or on the order detail page.
- Besides a current WordPress and WooCommerce installation, an account on sqrip.ch is required.
- You need a (QR-)IBAN of a Swiss/Liechtenstein bank.
- Customers must be able to transfer payments using this method.
- Invoice amounts must be in CHF or EUR.
- The data transmitted to sqrip for the purpose of creating the QR invoice (e.g. payer, amount) will be deleted within a defined period.
- On https://api.sqrip.ch each production/delivery is recorded in a logbook with date/time, origin (e.g. WooCommerce), API key called and product delivered.
What do I need to start?
- A sqrip account (http://api.sqrip.ch/login);
- An API key that can be created in the account;
- A (QR) IBAN.
How much will a QR invoice cost me?
We charge according to actually used QR invoices. One QR invoice costs 1 credit. Credits can be purchased in packages of 100 pcs. (for CHF 20) to 20’000 pcs. (for CHF 1’000) – each plus 7.7% VAT. The lowest price for a QR-bill is therefore 5 centimes (CHF 0.05).
Can I try the solution for free?
Yes. Registration (http://api.sqrip.ch/login) is free of charge. No credit card details are required. There are 20 credits to try it out. With this you can test all functions (test e-mail!). Afterwards you can buy packages with credits. If you do not like the service, you can simply delete the account again.
Will the service be developed further?
Yes. We are already working on comparing the reconciliation of orders/purchases with the payments received on the bank account, thus automatically tracking the status of an order. Our goal remains: To offer a cheap, simple, full-value and reliable payment method. We are happy to receive your ideas for this.
What are the best reasons to use sqrip with our store?
- sqrip is set up in 5 minutes – IT knowledge is not necessary.
- sqrip detects when uninvited guests change the payee IBAN in their favor.
- sqrip was developed by store operators – we know the needs of our customers.
- We do not want to stand still ourselves. That’s why we continue to develop sqrip. The roadmap stands.
- Only free is even cheaper. A QR bill is available from 5 centimes. For transactions with credit card or Twint, only the fixed amounts are higher.
Contributors & Developers
“sqrip – Swiss QR Invoice” is open source software. The following people have contributed to this plugin.Contributors
“sqrip – Swiss QR Invoice” has been translated into 3 locales. Thank you to the translators for their contributions.
Translate “sqrip – Swiss QR Invoice” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
1.6 : March 2023
- Validation of API keys shows API key name for better identification;
- A hint placed right of the button for sending test e-mails tells you if a bought credit is used for it;
- Test e-mails include initial numbers of QR-Reference;
- Design and Text improvements;
- Bug fixing.
We made users (even more) happy with these changes:
* Plugin is no longer loaded on every page;
* Supressing generation of QR-reference at checkout;
* Manually added orders requires less data, shows specific error message when mandatory fields are void;
* Select the order status for unpaid and paid orders. Should there be no suitable status for paid orders (e.g. “paid, processing”), add one quickly;
* Easier manual payment comparison on list of orders page and on order detail page. With just one click the status is updated;
* allowing allow_url_open in the PHP settings to prevent issues with downloading and local storing of PDF.
- Content of ‘Additional Information’ is correctly shown (with some dummy data) in the test e-mail.
- Bug fixes
- Add Refund token validation;
- Shows QR-invoice on checkout screen;
- Deletes unnecessary/old QR-invoices in media library.
- Bug fixes
- New pictures added to wordpress entry;
- deleted the hash # in the default field after report of problems with certain banking Apps;
- ZIP-Codes with initial “CH-” are now possible;
- Added company field to payee address.
- Use default settings if sqrip WC options have not been set before.
- Added company field to QRCode;
- More flexibility with additional information on the QR invoice;
- Remove Duplicate due date field;
- Text adjustments;
- Minor bug fixes.
- Allow adding sqrip payment method to manually added orders;
- Define the order status that will add the qr-invoice to the outgoing e-mail;
- PDF files are replaced with new version when QR-invoice is renewed;
- Support for WPML;
- Plugin in available in French and Italian;
- Minor bug fixes.
- Plugin is now available in German;
- Adjustments in text strings.
- Public Beta: Refunds;
- Multiple bug fixes.
- Pictures updated
- Allows to update the QR invoice per order;
- Adaptation to description and the images;
- Minor bug fixes.
- Validates API key and connection to api.sqrip.ch;
- Integrates security process when (QR) IBAN is changed: Informs account holder of change which must be either actively confirmed or passively allowed. Disables payment method as a precaution;
- Allowed adjustment address payee;
- Checks (QR) IBAN and explains difference or advantages;
- Allows (QR) reference numbers based on a random number or the order number;
- Simplified delivery options and added due date;
- Enables sending a test email to the store admin;
- Revision of information display;
- Minor bug fixes.
- Allowed adjustment address payee;
- We now distinguish between IBAN and QR-IBAN.
- Here we go!