Skip to content

Latest commit

 

History

History
98 lines (70 loc) · 4.84 KB

README.md

File metadata and controls

98 lines (70 loc) · 4.84 KB

qrbill Go package

The qrbill package implements generating QR-bill QR codes, which is a Swiss 🇨🇭 payment standard:

These QR codes fill in details of a bank wire transfer, either all fields or just some of them.

Recipients can scan the QR code with their mobile banking app, or with their online banking web site’s mobile scan functionality, making it much easier to send a wire transfer.

An example use case is for an association or club: you can send out payment instructions to your members to collect membership fees (“Einzahlungsschein”).

Validity

The SIX QR-bill validation portal successfully confirms that e.g. the code at the top right is valid.

qrbill API (Example program)

To install the program:

go install github.com/stapelberg/qrbill/cmd/...

To run the program, run qrbill-api in the terminal. You will see an output like this:

% qrbill-api
2020/06/25 23:32:52 QR Bill generation URL: http://localhost:9933/qr?format=html

You can append the URL parameters on the left to customize the code. E.g.:

http://localhost:9933/qr?format=html&udname=Mary+Jane&udaddr1=Artikel+19b

When you open the URL in your web browser, you should see the following debug output:

When you scan the resulting QR code with your eBanking app, you should see a form like this:

Once you are happy with the code parameters, change the format parameter from html to png, e.g.:

http://localhost:9933/qr?format=png&udname=Mary+Jane&udaddr1=Artikel+19b

Crowd-sourced compatibility testing

To build confidence in our implementation, please help us verify that the codes scan as expected!

qrbill v0.1.3 (2020-Sep-10)

Scan each of the following 3 QR codes in your eBanking app, program or web interface, then file an issue (or send a pull request) with your test results! Thank you very much.

donation invoice invoice without amount
donation parameters invoice parameters invoice without amount parameters
QR code scanned with paid via Notes
donation SIX QR-bill validation
invoice SIX QR-bill validation
invoice without amount SIX QR-bill validation
donation ZKB eBanking (iOS) ZKB
invoice ZKB eBanking (iOS)
invoice without amount ZKB eBanking (iOS)
donation Revolut (iOS)
invoice Revolut (iOS) message replaced with revolut text!
invoice without amount Revolut (iOS) message replaced with revolut text!
donation Zak - Bank Cler (Android) no mention of "Mary Jane" or "Artikel 19"
invoice Zak - Bank Cler (Android) no mention of "Mary Jane" or "Artikel 19"
invoice without amount Zak - Bank Cler (Android) no mention of "Mary Jane" or "Artikel 19"
donation Bank Linth (iOS)
invoice Bank Linth (iOS)
invoice without amount Bank Linth (iOS)