Facturation et abonnement

Les paiements sont gérés par Stripe. L'API ne manipule jamais de numéro de carte : elle renvoie des liens vers les pages sécurisées de Stripe (Checkout pour souscrire, portail client pour gérer le moyen de paiement et les factures). L'état de l'abonnement est ensuite mis à jour par les webhooks Stripe.

Les formules et leurs limites :

État de l'abonnement#

GET /v1/billing · Jeton

curl https://api.monsiteo.com/v1/billing \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{
  "plan": "site",
  "limits": { "name": "Site", "formula": 1, "monthly": 9, "yearly": 90, "stripe_monthly": "price_...", "stripe_yearly": "price_...", "sites": 1, "pages": 30, "custom_domain": true, "branding": false, "ai_generations": 50, "storage_mb": 2048, "novadesko": false },
  "trial_eligible": false,
  "subscription": {
    "id": 12,
    "plan": "site",
    "interval": "month",
    "status": "active",
    "on_trial": false,
    "trial_ends_at": "2026-10-24T14:02:11+00:00",
    "current_period_end": "2026-11-24T14:02:11+00:00",
    "cancel_at_period_end": false,
    "ends_at": null
  },
  "payments": [
    {
      "id": 55,
      "number": "MS-2026-0042",
      "status": "paid",
      "amount": 9,
      "currency": "EUR",
      "description": "Abonnement Monsiteo Site",
      "pdf_url": "https://pay.stripe.com/invoice/acct_.../pdf",
      "date": "2026-10-24T14:05:37+00:00"
    }
  ]
}

Bon à savoir Pendant un impayé (past_due), les fonctions payantes restent accessibles le temps des relances automatiques de Stripe. Si le paiement n'aboutit pas après la dernière relance, Stripe met fin à l'abonnement (selon les réglages de relance du compte Stripe) et le compte repasse en Gratuit.

Souscrire (Checkout)#

POST /v1/billing/checkout · Jeton

Renvoie l'URL d'une session Stripe Checkout. Redirigez l'utilisateur vers cette URL : il y saisit son moyen de paiement, son adresse de facturation (obligatoire) et éventuellement son numéro de TVA et un code promo. Il revient ensuite sur https://app.monsiteo.com/#/billing?checkout=success (ou checkout=cancel s'il abandonne).

curl -X POST https://api.monsiteo.com/v1/billing/checkout \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd" \
  -d '{"plan":"site","interval":"year"}'

{ "url": "https://checkout.stripe.com/c/pay/cs_test_a1B2c3D4..." }

Si le compte est éligible, l'abonnement démarre par 14 jours d'essai : aucun montant n'est prélevé avant la fin de l'essai. La formule est appliquée dès que Stripe confirme la souscription par webhook, en général quelques secondes après le retour.

Erreurs : 422 si plan ou interval est invalide, ou « Formule inconnue ou non configurée dans Stripe. ».

Attention Pour changer de formule ou de rythme de paiement quand un abonnement est déjà en cours, passez par le portail client plutôt que par une nouvelle session Checkout, afin de ne pas créer un second abonnement chez Stripe.

Portail client Stripe#

POST /v1/billing/portal · Jeton

Renvoie l'URL du portail client Stripe : moyen de paiement, adresse et numéro de TVA, historique et téléchargement des factures, et selon la configuration du portail, changement de formule. Retour vers https://app.monsiteo.com/#/billing.

curl -X POST https://api.monsiteo.com/v1/billing/portal \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "url": "https://billing.stripe.com/p/session/test_YWNjdF8x..." }

Résilier#

POST /v1/billing/cancel · Jeton

Demande l'arrêt de l'abonnement à la fin de la période en cours (ou à la fin de l'essai). Les fonctions payantes restent disponibles jusque-là, puis le compte repasse en Gratuit : les sites restent en ligne sur leur adresse .monsiteo.com, avec les limites de la formule Gratuit.

curl -X POST https://api.monsiteo.com/v1/billing/cancel \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "ok": true, "ends_at": "2026-11-24T14:02:11+00:00" }

Sans abonnement en cours : {"ok": false, "ends_at": null}.

Annuler la résiliation#

POST /v1/billing/resume · Jeton

Tant que la date de fin n'est pas atteinte, annule la résiliation : l'abonnement continue normalement.

curl -X POST https://api.monsiteo.com/v1/billing/resume \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "ok": true }

Novadesko#

La formule Site + Novadesko inclut un compte Novadesko (logiciel de facturation) relié au compte Monsiteo. La liaison est lancée automatiquement à la souscription ; ces routes permettent de suivre son état ou de la relancer.

Lire l'état de la liaison#

GET /v1/novadesko · Jeton

{ "included": true, "status": "linked", "company_id": "8812", "login_url": "https://app.novadesko.com" }

Relancer la liaison#

POST /v1/novadesko/link · Jeton

curl -X POST https://api.monsiteo.com/v1/novadesko/link \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "status": "linked", "message": null }

message contient la dernière erreur éventuelle quand status vaut pending ou failed. Erreur 402 si la formule n'inclut pas Novadesko : « Novadesko est inclus dans la formule Site + Novadesko. ».