Avec Sign-up for mailcow, les visiteurs peuvent créer leurs propres comptes sur votre mailcow. Cashier for mailcow vous permet de les leur vendre : des formules de boîtes aux lettres et des paquets de domaines, payés mensuellement ou annuellement par carte via votre propre compte Stripe, et appliqués à mailcow dès que le paiement est confirmé. Il est livré dans le paquet du mailcow Toolkit (0.4.0 ou plus récent), a sa propre licence et nécessite Sign-up.
Ce qu’il fait
Votre compte Stripe, vos paiements
- Les paiements vont directement sur votre propre compte Stripe. MediaLab Works ne voit ni ne traite jamais les paiements de vos clients : Cashier dialogue avec Stripe depuis votre serveur, avec vos clés.
- Une restricted key est recommandée, avec un accès en écriture à Customers, Checkout Sessions, Customer portal, Products, Prices, Subscriptions, Subscription items et Webhook Endpoints, et en lecture à Invoices. La clé est vérifiée auprès de Stripe, stockée chiffrée sur votre serveur et n’est plus jamais affichée.
- Le webhook est créé dans votre compte Stripe depuis la page d’administration. Chaque événement est vérifié par sa signature et traité une seule fois (un événement répété ne change rien), avec une version d’API Stripe épinglée.
- Les clés de test et les clés live fonctionnent toutes les deux ; la page indique le mode connecté.
Formules et options
- Formules de boîtes aux lettres (une boîte aux lettres avec son quota) et paquets de domaines (nombre de domaines, de boîtes aux lettres, d’alias et quota par domaine, quota par défaut de la boîte aux lettres), avec noms et descriptions en anglais et en roumain.
- Prix mensuels et/ou annuels, jours d’essai et formules cachées accessibles uniquement via leur lien direct ou un code d’invitation.
- Options achetées en quantité : des boîtes aux lettres supplémentaires sur chaque domaine du paquet, ou du stockage supplémentaire. Les changements de formule et les options sont calculés au prorata par Stripe et appliqués à mailcow aussitôt.
- Une formule ou un paquet inférieur à l’usage actuel du client est refusé, avec l’indication de ce qu’il faut d’abord réduire. Rien n’est supprimé pour que cela rentre.
Quand un paiement échoue
- Le compte continue de fonctionner pendant un délai de grâce de votre choix (0 à 90 jours), et le client reçoit un e-mail avec le lien pour payer.
- Après le délai de grâce, le compte est suspendu. Par défaut, « no sign-in » : les boîtes aux lettres continuent de recevoir du courrier, mais personne ne peut se connecter et l’administrateur de domaine est inactif. Vous pouvez choisir à la place « inactive » : les boîtes aux lettres, l’administrateur de domaine et les domaines sont désactivés dans mailcow.
- Un paiement rétablit le compte aussitôt, exactement comme il était. Rien n’est jamais supprimé.
- Une résiliation conserve tout jusqu’à la fin de la période payée. Ensuite, un compte créé par l’abonnement reste suspendu ; un compte qui a acheté une formule après une inscription gratuite repasse au paquet gratuit quand il y rentre.
Pour vos clients
- L’abonnement sur My account : la formule, la date de renouvellement, les options, Change plan, et le portail client Stripe pour la carte, les factures et la résiliation.
- Des e-mails en anglais ou en roumain : nouvelle facture, reçu, paiement échoué, suspendu (avec le lien pour payer), de nouveau actif, bientôt terminé et terminé.
- Une page publique,
/mlw-cashier/billing.php, envoie par e-mail le lien de paiement d’une facture ouverte à un client suspendu qui ne peut pas se connecter.
Pour vous
- La liste des abonnés avec le chiffre d’affaires mensuel, chaque abonnement lié à Stripe, et les événements Stripe récents.
- Accords gratuits : donnez une formule à un compte pour un nombre de jours, sans Stripe.
- Sans licence, aucun nouveau paiement ne démarre. Les webhooks des abonnés existants sont toujours traités et un paiement terminé entre-temps attend le retour de la licence ; les comptes existants ne sont jamais touchés.
Prérequis
- Le paquet mailcow Toolkit 0.4.0 ou plus récent sur mailcow-dockerized (Linux,
docker compose, systemd) ; Cashier fait partie du paquet. - Sign-up for mailcow avec sa propre licence valide : les comptes payants sont créés via sa page d’inscription.
- Votre propre compte Stripe (dans un pays pris en charge par Stripe) et une restricted key avec les permissions ci-dessus.
- L’interface mailcow accessible depuis Internet en HTTPS, pour que Stripe puisse appeler le webhook (
/mlw-cashier/webhook.php). - Le serveur doit atteindre medialab.works en HTTPS (vérification de licence) et api.stripe.com.
Questions fréquentes
Les paiements passent-ils par MediaLab Works ? Non. L’argent, les factures et les données clients dans Stripe se trouvent dans votre propre compte Stripe ; nous ne sommes pas partie à vos ventes. Les conditions de Stripe s’appliquent entre vous et Stripe.
Que devient une boîte aux lettres quand un client cesse de payer ? Elle est suspendue après le délai de grâce, jamais supprimée. Avec le mode par défaut, elle continue de recevoir du courrier, donc rien n’est perdu ; un paiement tout rallume.
Un client peut-il passer à une formule inférieure ? Oui, si ce qu’il utilise rentre dans la nouvelle formule. Sinon, le changement est refusé et la page indique quoi réduire.
Où les données sont-elles conservées ?
Les formules, les clients et les abonnements se trouvent dans la base de données de mailcow (tables mlw_ca_*), donc dans les sauvegardes de mailcow. Les clés Stripe sont chiffrées, et la clé de déchiffrement est conservée à part dans le redis de mailcow.
Licence
Cashier for mailcow est open source (GPL-3.0), comme mailcow et le Toolkit. Ce que vous achetez, c’est l’abonnement aux nouvelles versions, aux mises à jour et au support pour un serveur mailcow, avec sa propre clé de licence et son propre essai gratuit de 30 jours ; le pack mailcow couvre le Toolkit, Sign-up et Cashier avec une seule clé. C’est du PHP et du JavaScript : vous recevez donc le code source complet. Voir la section 11 de la Licence (CLUF).
Cashier for mailcow est notre propre code, écrit par MediaLab Works ; il ne contient aucun code tiers ni de SDK Stripe (il appelle directement l’API publique de Stripe). mailcow est un projet open source distinct (GPL-3.0) de The Infrastructure Company GmbH ; Stripe est un service de paiement distinct, utilisé uniquement avec votre propre compte. Voir Droits d’auteur.