Descrizione
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.
Al fine di offrire questa opzione di pagamento a basso costo con tutti i suoi vantaggi in futuro, abbiamo sviluppato sqrip. sqrip per WooCommerce consiste in un’API universale (http://api.sqrip.ch/) e un plugin per WordPress, che si collega perfettamente con WooCommerce e si presenta con varie opzioni. Il plugin è “open source” (https://github.com/netmex/sqrip-woocommerce) e può quindi essere adattato ad altri sistemi di negozio.
Come funziona
sqrip è elencato come un metodo di pagamento aggiuntivo in WooCommerce e può essere configurato lì. Per l’identificazione e la fatturazione, ma anche per motivi di sicurezza, il plugin è collegato all’account sqrip tramite una chiave API/token. La fattura QR viene creata dall’API, consegnata e salvata nel formato desiderato nella libreria multimediale. Da lì, il file può essere integrato in vari luoghi (ad esempio come inserto nella mail di conferma) e riaperto in qualsiasi momento. Se la fattura è stata modificata, la parte di pagamento QR può essere aggiornata con un clic. Il numero di riferimento è esposto in modo visibile con l’ordine, in modo che un confronto possa essere fatto rapidamente.
Buono a sapersi
- La fattura di WooCommerce non viene toccata. La fattura QR è un documento PDF separato.
- L’IBAN normale o il nuovo QR-IBAN possono essere usati come conto destinatario. Con un QR-IBAN, i pagamenti possono essere effettuati solo specificando un riferimento QR (numero). Questo permette di assegnare chiaramente ogni singolo pagamento a un cliente/ordine. La corrispondenza automatica dei pagamenti ricevuti con gli ordini è così possibile. Questa è la base per un’ulteriore (parziale) automazione.
- Un account sqrip può essere collegato a più negozi. Sono possibili più chiavi API.
- Ogni chiave API dovrebbe essere sostituita dopo una durata auto-selezionata. È quindi possibile definire una data di scadenza. Dopo questa data, QR Invoice non può più essere offerto senza aggiustamenti da parte del proprietario del negozio. Una nuova chiave API deve essere creata e collegata.
Opzioni
sqrip offre varie opzioni:
a) Nome e descrizione del metodo di pagamento
Nominate il metodo di pagamento ‘bonifico bancario’ o ‘deposito’ o come volete voi.
b) Beneficiario
Il beneficiario è preso automaticamente dal conto sqrip o dalle impostazioni di WooCommerce. La regolazione manuale è possibile.
c) (QR-)IBAN
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 five lines or 140 characters 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 field supports WPML.
f) Integration
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.
h) Language
– 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
– Suppress the creation of the QR invoice at checkout and define the status of the order.
– 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.
m) Payer Name
For corporate payers, choose to show either the Company name or the Firstname / Name. Or show all names together.
n) File Name
The QR invoice file names can be defined individually. Add date, order number and any other information as shop name to make the QR invoice more personal.
o) Delete unneeded QR invoice automatically
Keeps the size of the media library small. sqrip deletes all QR invoice files if
– certain status of the order are met (e.g. Cancelled);
– x days after the creation have passed.
p) Adjustable to your process
sqrip is flexible enough to be adopted to your individual process.
– Define your own order status for payments made with sqrip;
– Define the moment you expect the payment to arrive (prior to shipment or thereafter);
– Define the status after payment has arrived.
q) Shows when something is wrong, turns off automatically
Instead of showing technical, unuseful error messages to your clients, we turn the service off automatically and show you where to look at for resolving the issue.
Requisiti
- Oltre a un’installazione attuale di WordPress e WooCommerce, è necessario un account su sqrip.ch.
- Hai bisogno di un (QR-)IBAN di una banca svizzera/liechtenstein.
- I clienti devono essere in grado di trasferire i pagamenti con questo metodo.
- Gli importi delle fatture devono essere in CHF o EUR.
Protezione dei dati
- The data transmitted to sqrip for the purpose of creating the QR invoice (e.g. payer, amount) will be deleted within a defined period.
- Su https://api.sqrip.ch, ogni produzione/consegna è registrata in un registro con data/ora, origine (per esempio WooCommerce), chiave API chiamata e prodotto consegnato.
Screenshot
FAQ
-
Di cosa ho bisogno per iniziare?
-
- A sqrip account (http://api.sqrip.ch/login);
- Una chiave API che può essere creata nell’account;
- A (QR) IBAN.
-
Quanto mi costerà una fattura QR?
-
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 VAT. The lowest price for a QR-bill is therefore 5 centimes (CHF 0.05).
-
Posso provare la soluzione gratuitamente?
-
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.
-
Il servizio sarà sviluppato ulteriormente?
-
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.
-
Quali sono le migliori ragioni per usare sqrip con il nostro negozio?
-
- sqrip si configura in 5 minuti – non sono necessarie conoscenze informatiche.
- sqrip riconosce quando gli ospiti non invitati cambiano l’IBAN del beneficiario a loro favore.
- sqrip è stato sviluppato da operatori di negozi – conosciamo le esigenze dei nostri clienti.
- Noi stessi non vogliamo stare fermi. Ecco perché continuiamo a sviluppare sqrip. La tabella di marcia è fissata.
- Solo che gratis è ancora più conveniente. Una banconota QR è disponibile a partire da 5 centesimi. Per le transazioni con carte di credito o Twint, solo gli importi fissi sono più alti.
Recensioni
Contributi e sviluppo
“sqrip.ch” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
Collaboratori“sqrip.ch” è stato tradotto in 3 lingue. Grazie ai traduttori per i loro contributi.
Traduci “sqrip.ch” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il codice segui il repository SVN, segui il log delle modifiche tramite RSS.
Changelog
1.8.4 : May 2024 – Compatibility
- Solved an issue that prevented the sqrip box to be shown on the order details page;
- Killed the bug that prevented showing the qr-invoice in the e-mail or on the checkout page;
- Made sure that the CRON-Job for deleting no longer needed documents in the media library is executed properly.
1.8.3 : April 2024 – Performance
- Performance improvement.
1.8.2 : April 2024 – adjustments in API Call
- We reduced the amount of data needed to perform an API call.
1.8.1 : March 2024 – minor adjustments
- Date format adjusted to PHP 8.2.
1.8 : March 2024 – Major Service Update
- Working with PHP 8.2, WordPress 6.4 and Block Checkout;
- Added the number of remaining credits;
- Added ‘Current sqrip status’: See what’s wrong to fix it quickly.
- Added ‘Auto Turn-off’ functionality: Should any parameter be wrong (e.g. no credits left, API key inactive, unknown errors), sqrip will turn itself off in order to prevent any errors visible for the shop clients;
- Define an individual status for orders made with the sqrip payment method;
- The status can be changed for multiple orders now, incl. to the status defined by the merchant;
- Select that no QR bill must be attached to any e-mail;
- Minor bug fixing.
1.7.5 : November 2023 – Service Update
- Added a new Tab “Services”;
- Assign you own status to new orders made with sqrip;
- Allows to select your own status in the list of orders;
- Easy to understand error messages;
- Minor bug fixing.
1.7.4 : June 2023 – Service Update
- Automatic changes in order status are prevented.
1.7.3 : May 2023 – Service Update
- Issues with file name adjustments solved;
- Payment Comparison can be turned off, preventing order status mix-up;
- Problems in some instances with the API token verification resolved.
1.7.2 : May 2023 – Service Update
- Link to updated QR invoice corrected;
- Individual file naming corrected;
- Potential error in attribution of QR invoices to e-mails corrected;
- Empty “additional information” field does no longer trigger an error;
- In case of a refund to a shop client: hint to unknown IBAN is shown;
- Minor Bug fixes.
1.7 : April 2023
- To save space in your media library on your server the QR Invoices (PDF) are automatically deleted, if certain status of the order are met (e.g. Cancelled) or x days after the creation have passed;
- Inital 6 digits for Reference Numbers are now available in combination with regular IBAN. Letters are possible (e.g. “RF39 SQRI PX11 1115 2023 0331 0”);
- The reference numbers are now shown in groups;
- Define a suitable order status when waiting for payments or when no QR invoice has been created;
- Show message when the (QR-)IBAN in the plugin is different from the one on api.sqrip.ch;
- Bug fixing.
We made users (even more) happy with these changes:
* Give individual names to your QR invoice files. Add your shop name, the order number and the order date (e.g. QRRechnung_babytuch_20230331_Bestellung_2503.pdf).
* For corporate payers with a contact person both names can be added to the QR invoice. Optional only one of them is shown;
* Manually created orders do not need the e-mail of the client anymore.
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.
1.5.6
- Content of ‘Additional Information’ is correctly shown (with some dummy data) in the test e-mail.
1.5.5
- Bug fixes
1.5.4
- Add Refund token validation;
- Shows QR-invoice on checkout screen;
- Deletes unnecessary/old QR-invoices in media library.
1.5.3
- Bug fixes
1.5.2
- 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.
1.5.1
- Use default settings if sqrip WC options have not been set before.
1.5
- Added company field to QRCode;
- More flexibility with additional information on the QR invoice;
- Remove Duplicate due date field;
- Text adjustments;
- Correzioni di bug minori.
1.4
- Refunds;
- 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;
- Correzioni di bug minori.
1.3.1
- Plugin is now available in German;
- Adjustments in text strings.
1.3
- Public Beta: Refunds;
- Multiple bug fixes.
1.2.1
- Immagini aggiornate
1.2
- Permette di aggiornare la fattura QR per ordine;
- Adattamento alla descrizione e alle immagini;
- Correzioni di bug minori.
1.1
- Convalida la chiave API e la connessione a api.sqrip.ch;
- Integra il processo di sicurezza quando si cambia il (QR-)IBAN: Informa il titolare del conto del cambiamento che deve essere confermato attivamente o autorizzato passivamente. Disattiva il metodo di pagamento per precauzione;
- Indirizzo di aggiustamento consentito Beneficiario;
- Controlla il (QR-)IBAN e spiega la differenza o i vantaggi;
- Abilita i numeri di riferimento (QR) basati su un numero casuale o sul numero d’ordine;
- Semplifica le opzioni di consegna e aggiunge la data di scadenza;
- Permette di inviare un’email di prova all’amministratore del negozio;
- Revisione della presentazione delle informazioni;
- Correzioni di bug minori.
1.0.3
- Indirizzo di aggiustamento consentito Beneficiario;
- Distinguiamo ora tra IBAN e QR-IBAN
1.0.2
- Bugfixing
1.0.1
- Bugfixing
1.0
- Ci siamo!