Membear nutzt zahls.ch für die Online-Zahlung: Jede Rechnungs-E-Mail enthält einen Zahlungslink, über den Mitglieder zum Beispiel mit TWINT oder Karte bezahlen. Sobald zahls.ch die Zahlung meldet, steht die Rechnung in Membear auf Bezahlt.
Am Ende hast du: gespeicherte Zugangsdaten (damit ist der Rechnungsversand freigeschaltet) und einen Webhook, über den Zahlungen automatisch in Membear ankommen.
Zugangsdaten eintragen oder ändern können nur Besitzerinnen und Besitzer sowie die Kassierin oder der Kassier. Alle anderen sehen die Angaben nur. Jede Änderung meldet Membear der Hauptinhaberin oder dem Hauptinhaber des Vereins per E-Mail.
Ablauf auf einen Blick
- zahls.ch-Konto anlegen und Zahlungsarten aktivieren
- Instanz und API-Schlüssel im zahls.ch-Dashboard holen
- Beide Werte in Membear speichern – damit ist der Rechnungsversand freigeschaltet
- Webhook bei zahls.ch hinterlegen und mit einer Testtransaktion prüfen
1. zahls.ch-Konto anlegen
Noch kein Konto? Registriere den Verein auf zahls.ch und schliesse die Einrichtung dort ab. Aktiviere die Zahlungsarten, die deine Mitglieder nutzen sollen, zum Beispiel TWINT und Kreditkarte. Welche Zahlungsarten ein Mitglied sieht, bestimmst du in zahls.ch, nicht in Membear.
2. Instanz und API-Schlüssel holen
- Instanz: der Name in der Adresse deines zahls.ch-Kontos vor
.zahls.ch. Beimeinverein.zahls.chlautet die Instanzmeinverein– ohnehttps://und ohne.zahls.ch. - API-Schlüssel: im zahls.ch-Dashboard unter API und Plugins › API-Schlüssel hinzufügen, Name zum Beispiel
Membear. Mit Kopieren übernimmst du ihn; in der Liste unter API und Plugins kannst du ihn jederzeit erneut kopieren.
3. In Membear speichern
Du hast zwei Wege, beide schalten den Rechnungsversand frei:
Auf dem Dashboard: Im Schritt Zahlungsintegration auf zahls.ch einrichten klicken, dann Einrichtung starten. Instanz und API-Schlüssel eintragen und Konfiguration speichern.
In den Einstellungen: Einstellungen › Mitgliederzahlungen, Karte zahls.ch Integration. Instanz und API-Schlüssel eintragen und Einstellungen speichern.
Hauptbereich (vereinfacht)
Der farblich hervorgehobene Eintrag zeigt, wo du in der echten App klicken musst. Die Reihenfolge kann bei dir minimal abweichen.
Unter Einstellungen › Mitgliederzahlungen findest du die Karte zahls.ch Integration mit Anleitung, Webhook-URL und den Feldern für Instanz und API-Schlüssel.
Beim Speichern prüft Membear die Angaben direkt bei zahls.ch (Live-Check):
- In den Einstellungen speichert Membear nur, wenn der Live-Check klappt. Sonst erscheint eine Fehlermeldung.
- Im Dashboard-Dialog kannst du bei einem fehlgeschlagenen Live-Check trotzdem Speichern und ohne Live-Check fortfahren. Das hilft, wenn dein zahls.ch-Konto noch nicht vollständig freigeschaltet ist. Später klickst du erneut auf Konfiguration speichern, um den Check zu wiederholen.
Der gespeicherte API-Schlüssel wird nie wieder angezeigt. Lässt du das Feld in den Einstellungen leer, bleibt der bisherige Schlüssel erhalten. Mit Zugangsdaten löschen entfernst du die Verbindung; danach ist der Rechnungsversand wieder gesperrt.
4. Webhook einrichten
Über den Webhook meldet zahls.ch Membear jede Zahlung. Ohne Webhook bleiben online bezahlte Rechnungen in Membear offen.
Die Webhook-URL zeigt Membear im Dashboard-Dialog und in der Karte zahls.ch Integration. Sie hat die Form https://…/api/zahls/webhook/<vereins-kürzel>, wobei das Kürzel der Teil deiner Vereinsadresse in Membear nach /home/ ist. Kopiere sie mit Kopieren.
Im zahls.ch-Dashboard:
- Im Hauptmenü Webhooks öffnen
- Webhook hinzufügen
- Die URL aus Membear einfügen
- Als Webhook-Typ JSON wählen
- Unter Ereignissen mindestens Transaktion aktivieren
- Eine Testtransaktion senden und den Webhook speichern
Im Dashboard-Dialog wartet Membear auf die Testtransaktion (Warte auf Webhook-Verifizierung...) und zeigt danach Integration abgeschlossen. Mit Einrichtung abschliessen schliesst du den Dialog. Membear nimmt die Testtransaktion nur an, wenn die gespeicherten Zugangsdaten bei zahls.ch funktionieren.
Trägst du eine andere Instanz ein, setzt Membear die Webhook-Prüfung zurück. Passe dann auch den Webhook im zahls.ch-Konto an und sende erneut eine Testtransaktion.
Was danach automatisch passiert
Jede Zahlung, die zahls.ch meldet, prüft Membear direkt bei zahls.ch nach. Stimmen Betrag und Währung, setzt Membear die Rechnung auf Bezahlt. Was sonst noch geschieht, zum Beispiel die Buchung in Finanzen und die Aktivierung neuer Mitglieder, steht unter Zahlungen und Bankverbindung.
Weiter: Rechnungen erstellen und versenden oder direkt Jahresrechnungen versenden.
Häufige Fragen
Bezahlt bei zahls.ch, in Membear noch offen? Prüfe im zahls.ch-Dashboard den Webhook: URL exakt kopiert (ohne Leerzeichen am Ende), Typ JSON, Ereignis Transaktion aktiv. Weicht der bezahlte Betrag von der Rechnung ab, markiert Membear die Rechnung bewusst nicht als bezahlt und benachrichtigt den Vorstand.
Live-Check schlägt fehl? Instanz nur als Kurzname eingetragen? API-Schlüssel frisch kopiert? Konto bei zahls.ch vollständig freigeschaltet? Im Dashboard-Dialog kannst du trotzdem ohne Live-Check speichern.
Rechnungen erstellen ist gesperrt, obwohl zahls.ch eingerichtet ist? Dann fehlt etwas anderes, meist die Vereinsadresse oder bei aktivierter Banküberweisung die Bankverbindung. Der Hinweis Einrichtung erforderlich auf der Seite Rechnungen zeigt, was fehlt.
Mitglied sieht TWINT nicht? Aktiviere TWINT in deinem zahls.ch-Konto.
Brauche ich zusätzlich ein Bankkonto? Für die Online-Zahlung nicht. Für Banküberweisungen mit QR-Rechnung und für PDFs zum Ausdrucken schon: Zahlungen und Bankverbindung.