Cashier for mailcow

Mit Sign-up for mailcow können Besucher eigene Konten auf deinem mailcow anlegen. Cashier for mailcow lässt dich diese verkaufen: Postfach-Tarife und Domain-Pakete, monatlich oder jährlich per Karte bezahlt über dein eigenes Stripe-Konto und in mailcow angewendet, sobald die Zahlung bestätigt ist. Es kommt im Paket des mailcow Toolkit (0.4.0 oder neuer), hat eine eigene Lizenz und braucht Sign-up.

Was es macht

Dein Stripe-Konto, deine Zahlungen

• Zahlungen gehen direkt auf dein eigenes Stripe-Konto. MediaLab Works sieht oder verarbeitet die Zahlungen deiner Kunden nie: Cashier spricht von deinem Server aus mit Stripe, mit deinen Schlüsseln.
• Empfohlen wird ein eingeschränkter Schlüssel (restricted key) mit Schreibzugriff auf Customers, Checkout Sessions, Customer portal, Products, Prices, Subscriptions, Subscription items und Webhook Endpoints sowie Lesezugriff auf Invoices. Der Schlüssel wird bei Stripe geprüft, verschlüsselt auf deinem Server gespeichert und nie wieder angezeigt.
• Der Webhook wird von der Admin-Seite aus in deinem Stripe-Konto angelegt. Jedes Ereignis wird per Signatur geprüft und genau einmal verarbeitet (ein wiederholtes Ereignis ändert nichts), mit einer festgelegten Stripe-API-Version.
• Testschlüssel und Live-Schlüssel funktionieren beide; die Seite zeigt, welcher Modus verbunden ist.

Tarife und Zusatzoptionen

• Postfach-Tarife (ein Postfach mit seinem Kontingent) und Domain-Pakete (Anzahl der Domains, Postfächer, Aliasse und Kontingent pro Domain, Standardkontingent der Postfächer), mit Namen und Beschreibungen auf Englisch und Rumänisch.
• Monatliche und/oder jährliche Preise, Testtage und versteckte Tarife, die nur über ihren direkten Link oder einen Einladungscode erreichbar sind.
• Zusatzoptionen, die mit einer Menge gekauft werden: zusätzliche Postfächer auf jeder Domain des Pakets oder zusätzlicher Speicherplatz. Tarifwechsel und Zusatzoptionen werden von Stripe anteilig berechnet und sofort in mailcow angewendet.
• Ein Tarif oder Paket, das kleiner ist als das, was der Kunde jetzt nutzt, wird abgelehnt, mit dem Hinweis, was zuerst verkleinert werden muss. Damit es passt, wird nichts gelöscht.

Wenn eine Zahlung fehlschlägt

• Das Konto funktioniert während einer von dir gewählten Kulanzfrist (0 bis 90 Tage) weiter, und der Kunde bekommt eine E-Mail mit dem Link zum Bezahlen.
• Nach der Kulanzfrist wird das Konto gesperrt. Standardmäßig „keine Anmeldung“: Die Postfächer empfangen weiter E-Mails, aber niemand kann sich anmelden, und der Domain-Administrator ist inaktiv. Du kannst stattdessen „inaktiv“ wählen: Postfächer, Domain-Administrator und Domains werden in mailcow deaktiviert.
• Eine Zahlung stellt das Konto sofort wieder her, genau so, wie es war. Es wird nie etwas gelöscht.
• Eine Kündigung lässt alles bis zum Ende des bezahlten Zeitraums bestehen. Danach bleibt ein Konto, das durch das Abonnement angelegt wurde, gesperrt; ein Konto, das nach einer kostenlosen Registrierung einen Tarif gekauft hat, kehrt zum kostenlosen Paket zurück, wenn es hineinpasst.

Für deine Kunden

• Das Abonnement unter Mein Konto: Tarif, Verlängerungsdatum, Zusatzoptionen, Tarif wechseln und das Stripe-Kundenportal für Karte, Rechnungen und Kündigung.
• E-Mails auf Englisch oder Rumänisch: neue Rechnung, Beleg, Zahlung fehlgeschlagen, gesperrt (mit dem Link zum Bezahlen), wieder aktiv, endet und beendet.
• Eine öffentliche Seite, /mlw-cashier/billing.php, schickt einem gesperrten Kunden, der sich nicht anmelden kann, den Bezahllink einer offenen Rechnung per E-Mail.

Für dich

• Die Liste der Abonnenten mit dem monatlichen Umsatz, jedes Abonnement mit Stripe verlinkt, und die letzten Stripe-Ereignisse.
• Kostenlose Freischaltungen: Gib einem Konto einen Tarif für eine Anzahl von Tagen, ohne Stripe.
• Ohne Lizenz startet kein neuer Bezahlvorgang. Die Webhooks bestehender Abonnenten werden weiter verarbeitet, und ein in der Zwischenzeit abgeschlossener Bezahlvorgang wartet, bis die Lizenz wieder da ist; bestehende Konten werden nie angerührt.

Voraussetzungen

• Das mailcow Toolkit-Paket 0.4.0 oder neuer auf mailcow-dockerized (Linux, docker compose, systemd); Cashier ist Teil des Pakets.
• Sign-up for mailcow mit eigener gültiger Lizenz: Kostenpflichtige Konten werden über seine Registrierungsseite angelegt.
• Dein eigenes Stripe-Konto (in einem Land, das Stripe unterstützt) und ein eingeschränkter Schlüssel mit den oben genannten Berechtigungen.
• Die mailcow-Oberfläche aus dem Internet über HTTPS erreichbar, damit Stripe den Webhook (/mlw-cashier/webhook.php) aufrufen kann.
• Der Server muss medialab.works über HTTPS (Lizenzprüfung) und api.stripe.com erreichen.

Häufige Fragen

Laufen die Zahlungen über MediaLab Works? Nein. Das Geld, die Rechnungen und die Kundendaten in Stripe liegen in deinem eigenen Stripe-Konto; wir sind keine Partei deiner Verkäufe. Zwischen dir und Stripe gelten die Bedingungen von Stripe.

Was passiert mit einem Postfach, wenn ein Kunde nicht mehr zahlt? Es wird nach der Kulanzfrist gesperrt, nie gelöscht. Im Standardmodus empfängt es weiter E-Mails, es geht also nichts verloren; eine Zahlung schaltet alles wieder ein.

Kann ein Kunde in einen kleineren Tarif wechseln? Ja, wenn das, was er nutzt, in den neuen Tarif passt. Andernfalls wird der Wechsel abgelehnt, und die Seite sagt, was verkleinert werden muss.

Wo werden die Daten gespeichert? Tarife, Kunden und Abonnements liegen in der Datenbank von mailcow (Tabellen mlw_ca_*) und sind Teil der mailcow-Backups. Die Stripe-Schlüssel sind verschlüsselt; der Schlüssel zum Entschlüsseln wird getrennt davon im redis von mailcow aufbewahrt.

Lizenzierung

Cashier for mailcow ist Open Source (GPL-3.0), wie mailcow und das Toolkit. Was du kaufst, ist das Abonnement für neue Versionen, Updates und Support für einen mailcow-Server, mit eigenem Lizenzschlüssel und eigenem kostenlosem 30-tägigem Test; das mailcow-Paket umfasst Toolkit, Sign-up und Cashier mit einem Schlüssel. Es ist PHP und JavaScript, du erhältst also den vollständigen Quellcode. Siehe Abschnitt 11 der EULA.

Cashier for mailcow ist unser eigener Code, von MediaLab Works geschrieben; er enthält keinen Code Dritter und kein Stripe-SDK (es ruft die öffentliche API von Stripe direkt auf). mailcow ist ein eigenständiges Open-Source-Projekt (GPL-3.0) der The Infrastructure Company GmbH; Stripe ist ein eigenständiger Zahlungsdienst, der nur mit deinem eigenen Konto genutzt wird. Siehe Urheberrecht.