Cashier for mailcow

Cu Sign-up for mailcow vizitatorii își pot face singuri conturi pe mailcow-ul tău. Cashier for mailcow te lasă să le vinzi: planuri de cutie poștală și pachete de domenii, plătite lunar sau anual cu cardul prin propriul tău cont Stripe, aplicate în mailcow imediat ce plata e confirmată. Vine în pachetul mailcow Toolkit (0.4.0 sau mai nou), are licența lui și are nevoie de Sign-up.

Ce face

Contul tău Stripe, plățile tale

  • Plățile ajung direct în contul tău Stripe. MediaLab Works nu vede și nu procesează niciodată plățile clienților tăi: Cashier vorbește cu Stripe de pe serverul tău, cu cheile tale.
  • E recomandată o cheie restricționată, cu drept de scriere pe Customers, Checkout Sessions, Customer portal, Products, Prices, Subscriptions, Subscription items și Webhook Endpoints și drept de citire pe Invoices. Cheia e verificată la Stripe, păstrată criptat pe serverul tău și nu mai e afișată niciodată.
  • Webhook-ul se creează în contul tău Stripe din pagina de admin. Fiecare eveniment are semnătura verificată și e procesat o singură dată (un eveniment repetat nu schimbă nimic), cu versiunea API Stripe fixată.
  • Merg atât cheile de test, cât și cele live; pagina arată ce mod e conectat.

Planuri și suplimente

  • Planuri de cutie poștală (o cutie cu spațiul ei) și pachete de domenii (număr de domenii, cutii poștale, aliasuri și spațiu pe domeniu, spațiul implicit al unei cutii), cu nume și descrieri în engleză și română.
  • Prețuri lunare și/sau anuale, zile de probă și planuri ascunse, disponibile doar prin linkul lor direct sau printr-un cod de invitație.
  • Suplimente cumpărate cu o cantitate: cutii poștale în plus pe fiecare domeniu al pachetului sau spațiu în plus. Schimbările de plan și suplimentele sunt calculate proporțional de Stripe și aplicate imediat în mailcow.
  • Un plan sau un pachet mai mic decât ce folosește acum clientul e refuzat, cu ce trebuie redus întâi. Nu se șterge nimic ca să încapă.

Când o plată eșuează

  • Contul funcționează în continuare pe durata unei perioade de grație alese de tine (0 până la 90 de zile), iar clientul primește un e-mail cu linkul de plată.
  • După perioada de grație contul se suspendă. Implicit „fără conectare”: cutiile poștale primesc în continuare e-mailuri, dar nimeni nu se poate conecta, iar administratorul de domeniu e inactiv. Poți alege în schimb „inactiv”: cutiile poștale, administratorul de domeniu și domeniile se dezactivează în mailcow.
  • O plată reactivează contul imediat, exact cum era. Nu se șterge niciodată nimic.
  • La anulare totul funcționează până la sfârșitul perioadei plătite. Apoi un cont creat de abonament rămâne suspendat; un cont care a cumpărat un plan după o înregistrare gratuită revine la pachetul gratuit, dacă încape în el.

Pentru clienții tăi

  • Abonamentul în Contul meu: planul, data reînnoirii, suplimentele, Schimbă planul și portalul de client Stripe pentru card, facturi și anulare.
  • E-mailuri în engleză sau română: factură nouă, chitanță, plată eșuată, suspendare (cu linkul de plată), cont reactivat, abonament care se încheie și încheiat.
  • O pagină publică, /mlw-cashier/billing.php, trimite pe e-mail linkul de plată al unei facturi restante unui client suspendat care nu se poate conecta.

Pentru tine

  • Lista abonaților cu venitul lunar, fiecare abonament cu link spre Stripe, și evenimentele Stripe recente.
  • Planuri oferite gratuit: dai un plan unui cont pentru un număr de zile, fără Stripe.
  • Fără licență nu pornește nicio plată nouă. Webhook-urile abonaților existenți se procesează în continuare, iar o plată încheiată între timp așteaptă până revine licența; conturile existente nu sunt atinse niciodată.

Cerințe

  • Pachetul mailcow Toolkit 0.4.0 sau mai nou pe mailcow-dockerized (Linux, docker compose, systemd); Cashier face parte din pachet.
  • Sign-up for mailcow cu licența lui validă: conturile plătite se creează prin pagina lui de înregistrare.
  • Propriul tău cont Stripe (într-o țară în care funcționează Stripe) și o cheie restricționată cu drepturile de mai sus.
  • Interfața mailcow accesibilă din internet prin HTTPS, ca Stripe să poată apela webhook-ul (/mlw-cashier/webhook.php).
  • Serverul trebuie să ajungă la medialab.works prin HTTPS (verificarea licenței) și la api.stripe.com.

Întrebări frecvente

Plățile trec prin MediaLab Works? Nu. Banii, facturile și datele clienților din Stripe sunt în propriul tău cont Stripe; nu suntem parte la vânzările tale. Între tine și Stripe se aplică termenii Stripe.

Ce se întâmplă cu o cutie poștală când clientul nu mai plătește? Se suspendă după perioada de grație, nu se șterge niciodată. În modul implicit primește în continuare e-mailuri, deci nu se pierde nimic; o plată repornește totul.

Poate trece un client la un plan mai mic? Da, dacă ce folosește încape în noul plan. Altfel schimbarea e refuzată, iar pagina spune ce trebuie redus.

Unde se păstrează datele? Planurile, clienții și abonamentele sunt în baza de date a mailcow (tabelele mlw_ca_*), deci în copiile de rezervă ale mailcow. Cheile Stripe sunt criptate, iar cheia de decriptare stă separat, în redis-ul mailcow.

Licențiere

Cashier for mailcow este sursă deschisă (GPL-3.0), ca mailcow și Toolkit-ul. Ce cumperi este abonamentul de actualizări: versiuni noi, actualizări și suport pentru un server mailcow, cu cheia de licență și perioada de probă gratuită de 30 de zile proprii; pachetul mailcow acoperă Toolkit-ul, Sign-up și Cashier cu o singură cheie. E PHP și JavaScript, deci primești codul sursă complet. Vezi secțiunea 11 din EULA.

Cashier for mailcow este cod propriu, scris de MediaLab Works; nu conține cod de la terți și niciun SDK Stripe (apelează direct API-ul public Stripe). mailcow este un proiect separat cu sursă deschisă (GPL-3.0) al The Infrastructure Company GmbH; Stripe este un serviciu de plăți separat, folosit doar cu propriul tău cont. Vezi Drepturi de autor.