Damit du Jahresrechnungen versenden und Online-Zahlungen automatisch abgleichen kannst, verbindest du deinen Verein einmal mit zahls.ch. Ohne diese Einrichtung bleibt der Rechnungsversand in Membear gesperrt.
Am Ende hast du: TWINT und Kartenzahlung für Mitglieder, Zahlungseingänge landen von selbst auf der richtigen Rechnung — ohne Listen in Excel nachzuführen.
Richte zahls.ch vor deinem Jahreslauf ein. Erst wenn Membear die Verbindung als verifiziert anzeigt, kannst du Rechnungen versenden.
Ablauf auf einen Blick
- zahls.ch-Konto anlegen und Zahlungsarten aktivieren
- Instanz und API-Schlüssel im zahls.ch-Dashboard besorgen
- Beide Werte in Membear speichern
- Webhook bei zahls.ch hinterlegen und mit einer Testtransaktion verifizieren
Optional danach: Bankverbindung für QR-Überweisungen unter Zahlungsintegration.
Vor dem Start
- zahls.ch-Konto für den Verein (oder Zugang zum bestehenden Konto)
- TWINT und/oder Kreditkarte im zahls.ch-Konto aktiviert, wenn Mitglieder online bezahlen sollen
- Zugang zu Einstellungen in Membear oder zum Onboarding-Schritt zahls.ch auf dem Dashboard
1. zahls.ch-Konto anlegen
Noch kein Konto? Registriere den Verein auf zahls.ch und schliesse die Einrichtung nach dem ersten Login ab.
Aktiviere die Zahlungsarten, die ihr anbieten wollt — mindestens TWINT und Kreditkarte, wenn Mitglieder online bezahlen sollen.
2. Instanz und API-Schlüssel besorgen
Membear braucht zwei Angaben aus dem zahls.ch-Dashboard:
- Instanz — Kurzname deines Kontos (z. B.
meinvereinausmeinverein.zahls.ch) - API-Schlüssel — neu erzeugter Schlüssel unter API und Plugins
Nur den Kurznamen eintragen — ohne https:// und ohne .zahls.ch. Bei https://meinverein.zahls.ch/... lautet die Instanz meinverein. Der Name steht auch in der Willkommens-E-Mail oder unter Kontoinformationen im Dashboard.
API-Schlüssel erzeugen
- Im zahls.ch-Dashboard API und Plugins öffnen (Seitenleiste)
- API-Schlüssel hinzufügen wählen
- Namen vergeben, z. B.
Membear, und bestätigen - Den Schlüssel mit Kopieren übernehmen — in der Liste unter API und Plugins jederzeit erneut kopierbar
Erzeugst du einen neuen Schlüssel, trage ihn in Membear ein und ersetze den bisherigen Eintrag.
3. In Membear eintragen
Hier klicken
Einstellungen öffnen oder Onboarding-Schritt zahls.ch auf dem Dashboard
Dort trägst du Instanz und API-Schlüssel ein — dieselben Felder wie im Einrichtungsdialog.
Hauptbereich (vereinfacht)
Der farblich hervorgehobene Eintrag zeigt, wo du in der echten App klicken musst. Die Reihenfolge kann bei dir minimal abweichen.
Unter Einstellungen die zahls.ch-Einrichtung starten — oder den Schritt zahls.ch im Onboarding auf dem Dashboard.
- Instanz und API-Schlüssel einfügen
- Konfiguration speichern
Membear prüft die Angaben. Schlägt der Live-Check fehl, ist das Konto bei zahls.ch manchmal noch nicht freigeschaltet. Du kannst trotzdem ohne Live-Check speichern und mit Schritt 4 weitermachen.
4. Webhook einrichten
Damit Membear erfährt, wenn ein Mitglied per TWINT oder Karte bezahlt hat, hinterlegst du eine Benachrichtigungs-URL bei zahls.ch. Membear zeigt dir diese URL nach Schritt 3 — exakt kopieren, ohne Leerzeichen am Ende.
Im zahls.ch-Dashboard:
- Im Hauptmenü Webhooks öffnen
- Webhook hinzufügen
- Die URL aus Membear einfügen
- Als Webhook-Typ JSON wählen (nicht «PHP-Post»)
- Unter Ereignissen mindestens Transaktion aktivieren
- Optional: Erneut senden bei Fehler aktivieren
- Testtransaktion senden und den Webhook speichern
Membear erkennt die Testzahlung und markiert die Verbindung als verifiziert. Bis dahin bleibt der Rechnungsversand gesperrt.
Ohne Testtransaktion fehlt die Bestätigung in Membear — Zahlungen können dann offen bleiben, obwohl das Geld bei zahls.ch eingegangen ist.
5. Fertig — Rechnungen freischalten
Ist die Verbindung verifiziert, schliesst du den Dialog ab. Du kannst jetzt Rechnungen erstellen und versenden.
Weiter: Jahresrechnungen versenden
Häufige Fragen
Zahlung bei zahls.ch, in Membear noch «offen»?
Webhook-URL exakt kopiert? Format JSON? Testtransaktion gesendet und gespeichert?
Live-Check schlägt fehl?
Instanz nur als Kurzname (ohne URL)? API-Schlüssel neu kopiert? Konto bei zahls.ch vollständig freigeschaltet? Du kannst trotzdem ohne Live-Check speichern und den Webhook testen.
Rechnungsversand gesperrt?
Webhook-Schritt vollständig — in Membear muss die Verifizierung sichtbar sein.
Mitglied sieht kein TWINT?
Zahlungsarten im zahls.ch-Konto aktivieren und Rechnung erneut versenden.
Banküberweisung mit QR-Rechnung ergänzt du separat: Zahlungsintegration. Das ersetzt zahls.ch nicht.