QR-Rechnung Zahlungsweise aktivieren und verwenden

INHALTSVERZEICHNIS

• Gut zu wissen
• Buchung & Aktivierung
• Anpassung Dankes-Mail Template
• Anpassung individuelle Erfolgsseite
• Ablauf bei Auswahl im Formular
• Transaktionen manuell als eingegangen markieren

Die Zahlungsweise QR-Rechnung ist eine Zahlungsweise, mit der Organisationen in der Schweiz Ihren Spendenden das spenden per QR Code ermöglichen können.

Gut zu wissen

• QR-Rechnung (auch QR Code Rechnung genannt) ist eine Schweizer Zahlungsweise.
• Sie steht für einmalige Transaktionen zur Verfügung.

Buchung & Aktivierung

1. Vertrag:
   Der spezielle QR Rechnungs-Vertrag kann unter Payment > Zahlungsweisen gebucht werden (Weiterleitung in den Store).
2. Konfiguration:
   Danach muss die Zahlungsweise (unter Payment > Zahlungsweisen) aktiviert werden, in dem mindestens die Pflichtfelder (mit * markiert) befüllt werden:
   
   • optionale Felder:
     • BESR-ID (steht für BankEinzahlungsSchein mit Referenznummer ID): Eine 6-stellige ID, die nur für die QR-IBAN relevant ist. Wenn Sie eine QR-IBAN haben und diese nicht wissen, können Sie diese bei Ihrer Schweizer Bank erfragen. Falls Sie z.B. PostFinance Kund*in sind oder keine QR-IBAN haben: Feld leer lassen.
     • Text für Verwendungszweck: Es kann ein individueller Verwendungszweck eingetragen werden (Empfehlung).
3. Klicken Sie auf "QR-Rechnung" aktivieren (Checkbox oben)
4. Klicken Sie auf den Button speichern  .
5. Erst danach kann die Zahlungsweise in den gewünschten Formularenaktiviert werden.

Anpassung Dankes-Mail Template

Damit der Zahlteil in der Dankes-Mail versendet werden kann, muss die Funktion generell aktiv sein: Automatische Dankes-E-Mail einstellen und bei der Transaktion im Formular muss eine E-Mailadresse angegeben werden.

Wenn diese Bedingungen erfüllt sind, wird der Zahlschein immer automatisch als PDF Anhang übermittelt.

Damit der Anhang auch in der E-Mail textlich erwähnt wird, empfehlen wir eine if-Schleife speziell für die QR Rechnung-Zahlungsweise einzufügen, z.B. so:

{% if type_id == 21 %}Sie finden den QR Rechnungs-Zahlteil als PDF im Anhang.{% endif %}

Anpassung individuelle Erfolgsseite

Bei der automatischen Erfolgsseite ist keine Anpassung nötig, jedoch, wenn die individuelle Erfolgsseite genutzt wird.
Sollten Sie als Erfolgsseite die individuelle Erfolgsseite nach einer Transaktion nutzen, müssen hier ebenfalls Parameter mit übergeben werden, damit der Zahlteil auch auf Ihrer individuellen Erfolgsseite angezeigt wird:

• Die Parameter qr_code_id und qr_code_signature müssen in der individuellen Dankesseite angehängt werden.
  • So kann die URL Erweiterung aussehen:
    ?qr_code_id=%qr_code_id%&qr_code_signature=%qr_code_signature%
• Über den Endpunkt https://secure.fundraisingbox.com/payment/qrcode/downloadkönnen Zahlteil als SVG Binary bzw QR-Rechnung als PDF abgefragt werden.
  • Abfrage SVG Base64 Binary: https://secure.fundraisingbox.com/payment/qrcode/download?type=svg&id=[qrcodeBankTransferUuid]&signature=[qrcodeBankTransferSignature]
  • Link zu PDF: https://secure.fundraisingbox.com/payment/qrcode/download?type=pdf&id=[qrcodeBankTransferUuid]&signature=[qrcodeBankTransferSignature]

Folgende Beispiel-Implementierung für die Dankes-Seite soll Ihnen als Hilfestellung dienen (dieser Code müsste auf der Dankesseiten-Landingpage auf Ihrem CMS eingefügt werden):

Statisches Beispiel:

<div id="frb-qr-code-bank-transfer">

    <img src="https://secure.fundraisingbox.com/payment/qrcode/download?type=svg&id=[QR_CODE_ID]&signature=[QR_CODE_SIGNATURE]" width="740" height="525" alt="QR-Rechnung Zahlungsinformationen">

    <a href="https://secure.fundraisingbox.com/payment/qrcode/download?type=pdf&id=[QR_CODE_ID]&signature=[QR_CODE_SIGNATURE]" target="_blank">QR-Rechnung Zahlungsinformationen als PDF</a>

</div>

<div id="frb-qr-code-bank-transfer"></div>

<script defer>
    (function() {
        const container = document.getElementById('frb-qr-code-bank-transfer');
        const qrcodeBankTransferUuid = getURLParameter('qr_code_id');
        const qrcodeBankTransferSignature = getURLParameter('qr_code_signature');

        if (!qrcodeBankTransferUuid) return;
        if (!qrcodeBankTransferSignature) return;
        if(!container) return;

        createSVG();
        createPDFLink();

        function getURLParameter (urlParameterName) {
            const queryString = window.location.search;
            const urlParams = new URLSearchParams(queryString);
            return urlParams.get(urlParameterName);
        }

        function createSVG() {
            const svgContainer = document.createElement('div');
            svgContainer.innerHTML = 'Lade QR-Rechnung...';
            container.append(svgContainer);

            const imageElement = document.createElement('img');
            imageElement.src = 'https://secure.fundraisingbox.com/payment/qrcode/download?type=svg&id=' + qrcodeBankTransferUuid + '&signature=' + qrcodeBankTransferSignature;
            imageElement.alt = 'QR-Rechnung Zahlungsinformationen';
            imageElement.width = 740;
            imageElement.height = 525;
            imageElement.style.maxWidth = '740px';
            imageElement.style.width = '100%';
            imageElement.style.height = 'auto';
            imageElement.style.backgroundColor = '#ffffff';
            imageElement.addEventListener('error', function() {
                svgContainer.innerHTML = 'QR-Rechnung Zahlungsinformationen konnten nicht geladen werden.';
                svgContainer.classList.add('error');
            });
            svgContainer.innerHTML = '';
            svgContainer.append(imageElement);
        }

        function createPDFLink () {
            const downloadLinkContainer = document.createElement('div');
            downloadLinkContainer.innerHTML = 'Erstelle Download-Link...';
            container.append(downloadLinkContainer);

            const downloadElement = document.createElement('a');
            downloadElement.href = 'https://secure.fundraisingbox.com/payment/qrcode/download?type=pdf&id=' + qrcodeBankTransferUuid + '&signature=' + qrcodeBankTransferSignature;
            downloadElement.target = '_blank';
            downloadElement.innerHTML = 'QR-Rechnung Zahlungsinformationen als PDF';

            downloadLinkContainer.innerHTML = '';
            downloadLinkContainer.append(downloadElement);
        }
    })();
</script>

Ablauf bei Auswahl im Formular

Für Ihre Organisation:

• Sobald die QR-Rechnung im Formular verwendet wird, ist die Transaktion danach direkt in der FundraisingBox für Sie sofort sichtbar

Für Spendende:

• Sobald das Formular abgesendet wird:
  • Erfolgsseite:
    • sofern die automatische Erfolgsseite genutzt wird, ist der Zahlteil direkt sichtbar (und noch einmal separat als PDF herunterladbar):
      
    • sofern die individuelle Erfolgsseite genutzt wird, werden die Informationen nur sichtbar, wenn Sie die Anpassungen zuvor vorgenommen haben (siehe oben)
    • Hinweise für automatische und individuelle Erfolgsseite:
      • Der Teil "Zahlbar durch" wird nur dann ausgefüllt, wenn die Adresse (inkl. Land) im Formular abgefragt und durch die spendende Person angegeben werden. Fehlen Informationen, bleibt das ganze Feld leer.
      • Die zum Download angebotenen SVG & PDF Dateien werden aus Datenschutzgründen nach spätestens 48 Stunden gelöscht.
  • Dankes-Mail:
    • sofern die Dankes-Mail im Formular aktiviert ist und eine E-Mailadresse bei der Spende angegeben wurde, wird in der Dankes-Mail als PDF Anhang der Zahlteil noch einmal übermittelt
      

Transaktionen manuell als eingegangen markieren

Wichtig: Die Transaktion wartet dann auf manuelle Bearbeitung, da Sie den Zahlungseingang selbst auf dem Konto abgleichen und dann in der FundraisingBox eintragen müssen (Listenoperation: Aktion wählen > bearbeiten > Eingegangen am als Datum setzen oder einzeln via bearbeiten)

Screenshot zeigt die einzelne manuelle Bearbeitung (speichern im Anschluss):