# Forfaits et facturation

URL: https://wa.genuka.com/docs/billing
Language: French

> Vous payez au numéro WhatsApp. Meta facture directement les conversations de votre compte Business — nous ne prenons aucune marge sur vos messages.

## L'essai gratuit

Chaque nouveau compte démarre sur un **essai gratuit de 7 jours** du palier Growth, avec un numéro
WhatsApp et tout son quota de messages. Aucune carte n'est demandée. Choisissez un forfait avant la
fin de l'essai pour continuer à envoyer : passée l'échéance, le compte bascule en `past_due` —
l'API refuse les envois, mais le tableau de bord reste consultable et rien n'est supprimé. Le
paiement rétablit tout à l'identique.

## Qui facture quoi

Genuka opère en tant que Meta Tech Provider, et non comme BSP (Business Solution Provider). Vous
connectez votre propre compte WhatsApp Business (WABA), et **Meta facture ce WABA directement**
pour les conversations et les messages. Genuka ne se trouve jamais sur le chemin du coût des
messages : nous ne facturons pas le message et n'y appliquons aucune marge. Il n'y a ni crédits par
message ni portefeuille.

> [!NOTE]
> **Un quota, pas une facturation à l'unité**
>
> Votre forfait inclut un quota mensuel de messages sortants par numéro, et nous décomptons les
> envois par Genuka WA dessus. C'est un quota d'abonnement, hors frais Meta — vous n'êtes jamais
> facturé au message, ni par nous ni via nous, mais Meta continue de facturer ses propres frais par
> message directement à votre WABA, sans marge de Genuka.

## L'unité facturée, c'est le numéro

Un plan, c'est **une base qui couvre votre premier numéro, plus un tarif réduit pour chaque numéro
suivant**. Ce tarif baisse à mesure que le palier monte — 2 500, puis 2 200, puis 1 800 XAF par
mois — donc grandir, c'est ce qui achète la remise. Au moment de payer, vous choisissez un palier et
un nombre total de numéros ; ce nombre est figé pour la période (le mobile money est un encaissement
unique, sans prorata possible) et il joue deux rôles :

* **Il plafonne vos connexions.** Connecter un numéro de plus que ceux payés demande un nouveau
  paiement.
* **Il dimensionne votre quota de messages.** Le quota de la période vaut votre nombre de
  numéros × le quota unitaire du palier.

> [!NOTE]
> **Exemple**
>
> 3 numéros en Starter, facturés au mois, coûtent 5 000 + 2 × 2 500 = 10 000 XAF et incluent
> 3 × 500 = 1 500 messages sortants pour la période.

## Les paliers

Quatre paliers. Tous incluent l'accès à l'API REST et les webhooks entrants — recevoir les réponses
est le job principal, il n'est donc jamais réservé :

* **Starter** — jusqu'à 5 numéros (+2 500 XAF chacun), 500 messages par numéro et par mois,
  1 utilisateur, support standard.
* **Growth** — jusqu'à 15 numéros (+2 200 XAF chacun), 5 000 messages par numéro et par mois,
  5 utilisateurs, marque blanche, appels WhatsApp par l'API (agents vocaux) et support prioritaire.
* **Scale** — jusqu'à 100 numéros (+1 800 XAF chacun), 30 000 messages par numéro et par mois,
  15 utilisateurs, sous-comptes clients et support dédié. Appels WhatsApp inclus.
* **Enterprise** — sur devis : volume sur mesure, conditions sur mesure, SLA contractuel.

Ces quotas comptent vos envois par Genuka WA, hors frais Meta : les frais par message de Meta
restent facturés par Meta à votre WABA.

### Périodicité et devises

Les forfaits sont facturés **au mois ou à l'année**, et payer à l'année revient moins cher par
numéro — la remise dépend du palier, jusqu'à 40 % sur Starter en XAF, XOF et KES (23 % en EUR et en USD). Les tarifs sont disponibles en
**XAF, XOF, KES, EUR et USD**. Le XAF, le XOF et le KES (shilling kényan, la grille XAF au taux du
marché) se règlent par mobile money, l'EUR et l'USD par carte bancaire.

## Limites des forfaits

Trois limites chiffrées, toutes lisibles depuis l'API. Les fonctionnalités réservées (marque
blanche, appels WhatsApp, sous-comptes clients, support prioritaire) s'y ajoutent selon le palier :

* **Numéros** — le nombre de numéros WhatsApp connectables, c'est-à-dire ceux que vous avez payés.
* **Messages par période** — les messages sortants inclus, décomptés aussi bien sur les envois API
  que sur les destinataires de campagne. Remis à zéro au début de chaque période.
* **Utilisateurs** — les comptes du tableau de bord sur l'espace de travail.

## Lorsque vous atteignez une limite

Dépasser une limite n'échoue pas silencieusement. L'API rejette la requête avec un code HTTP `402`
et un code d'erreur identifiant la limite atteinte :

* `plan_limit_numbers` — vous avez déjà tous les numéros payés par votre forfait.
* `plan_limit_messages` — le quota de messages de la période est épuisé.
* `subscription_past_due` — l'essai ou la période payée est arrivé à échéance sans renouvellement.

Ajoutez des numéros à votre forfait, montez d'un palier, ou attendez la prochaine période. Une
campagne est vérifiée sur l'ensemble de sa liste avant le premier envoi : un lancement qui ferait
sauter le quota est refusé d'emblée plutôt que de s'arrêter à mi-parcours.

## Paiements

Les forfaits payants en XAF, XOF et KES sont encaissés par mobile money : via **Genuka Pay** au
Cameroun, via **pawaPay** dans les autres pays (MTN, Orange, Wave, Moov, M-Pesa au Kenya…). Les forfaits en EUR et
USD se paient par carte via **Stripe** (page de paiement hébergée). Aucun moyen de paiement ne
porte de mandat récurrent : chaque période est un nouvel encaissement, que vous déclenchez vous-même — nous ne
prélevons jamais rien sans votre validation.

## Vos factures

Une facture est émise pour chaque période facturée, et elle porte un numéro suivi (`INV-2026-0042`).
Il y en a de deux sortes, mais elles se lisent et se règlent de la même façon :

* **À la souscription** — vous choisissez un palier, la facture est émise et réglée dans la foulée.
* **Au renouvellement** — la facture de la période suivante est émise **7 jours avant** la fin de
  la période en cours, à échéance le jour où celle-ci se termine. Vous savez donc toujours combien
  et pour quand, avant que quoi que ce soit ne s'interrompe.

Retrouvez-les toutes dans le tableau de bord sous **Facturation > Voir toutes les factures** :
payées, à régler, en retard ou annulées. Chaque facture s'ouvre en détail — période couverte, base
et numéros supplémentaires ligne par ligne, tentatives de paiement — et s'imprime ou s'enregistre
en PDF depuis votre navigateur. Une facture non réglée se paie en un clic, par mobile money.

> [!NOTE]
> **Payer en avance ne coûte rien**
>
> Régler la facture de renouvellement avant l'échéance ne raccourcit pas votre période en cours :
> la nouvelle démarre le jour où l'actuelle se termine. Vous ne perdez aucun jour déjà payé.

Une facture peut être **annulée** dans deux cas, et rien n'est alors dû à ce titre : vous avez
changé de palier avant de la régler (elle est remplacée par la nouvelle), ou vous avez résilié à la
fin de la période.

## Gérer votre forfait

Consultez et gérez votre forfait dans le tableau de bord, sous **Facturation**, ou lisez votre
abonnement et vos factures par programmation :

| Méthode | Endpoint                | Description                                                                         |
| ------- | ----------------------- | ----------------------------------------------------------------------------------- |
| `GET`   | `/api/v1/subscription`  | Votre forfait actuel, ses limites, votre usage et la période de facturation.        |
| `GET`   | `/api/v1/invoices`      | Vos factures, les plus récentes d'abord. Filtrable avec `?status=open\|paid\|void`. |
| `GET`   | `/api/v1/invoices/{id}` | Une facture et ses tentatives de paiement.                                          |

Chaque facture expose un `status` stocké (`open`, `paid`, `void`) et un `state` calculé, qui
distingue une facture `due` d'une facture `overdue` — c'est une lecture d'horloge, pas une colonne.
