MonCashConnect pour SaaS en Haïti

Le problème

Les SaaS qui veulent vendre en HTG doivent composer avec un wallet qui n'a pas été conçu pour la facturation récurrente :

• ·MonCash ne permet pas, à ce jour, un débit silencieux périodique. Chaque renouvellement demande une confirmation explicite de l'utilisateur dans son app.
• ·Sans dashboard de statut clair, vous ne savez pas qui a payé, qui a sauté un cycle, qui est en past_due. Vous finissez à exporter des screenshots SMS pour faire votre compta.
• ·Tester un changement de plan ou un upgrade pro-rata sans casser la facturation réelle nécessite un environnement séparé — ce que le portail MonCash officiel n'expose pas.
• ·La logique de dunning (relances avant suspension) demande un évènement fiable. Un lien web simple n'est pas suffisant.

Comment MonCashConnect aide

MonCashConnect ne magie pas un débit silencieux MonCash — personne ne le peut. En revanche, voici ce qu'on couvre pour rendre le cycle d'abonnement vivable :

Cycle d'un abonnement mensuel à 1 200 HTG

1. J-3 : envoi du lien de renouvellement. Votre cron lit les abonnements dont next_billing_at approche. Pour chacun, vous créez un paiement reference_id: "sub_8821:cycle_14", vous envoyez l'URL au client par email ou notification in-app.
2. J-0 : le client paie depuis son MonCash. Il ouvre le lien, confirme dans son app, le wallet débite 1 200 HTG.
3. Webhook reçu : payment.completed avec la signature et votre reference_id. Vous mettez subscription.status = "active", next_billing_at = now + 30j, vous envoyez un reçu.
4. J+5 sans paiement : votre cron passe l'abonnement en past_due et limite l'accès aux fonctionnalités premium. Vous relancez par email.
5. J+10 toujours rien : l'abonnement passe en canceled. Si l'utilisateur revient, il recommence un cycle from scratch — vous re-créez un paiement neuf.

Côté webhook handler, le snippet critique :

// POST /webhooks/moncash
app.post("/webhooks/moncash", express.raw({ type: "application/json" }), async (req, res) => {
  let event;
  try {
    event = mcc.webhooks.constructEvent(
      req.body,                              // bytes bruts, AVANT JSON.parse
      req.headers["x-mcc-signature"],
      req.headers["x-mcc-timestamp"],
      process.env.MCC_WEBHOOK_SECRET,
    );
  } catch {
    return res.status(400).send("invalid signature");
  }

  if (event.event === "payment.completed") {
    const [subId, cycle] = event.reference_id.split(":");
    await renewSubscription(subId, cycle);     // idempotent
  }
  res.send("OK");
});

Quel plan vous convient

Un SaaS bénéficie surtout d'environnements isolés (prod, staging, dev local) et d'un plafond suffisant pour cashout, plus que d'un nombre élevé de transactions gratuites.

Détails complets sur la page Tarifs.

FAQ — SaaS