Genuka WA docs

Forfaits et facturation

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 14 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.

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 dessus. C'est un quota d'abonnement — vous n'êtes jamais facturé au message, ni par nous ni via nous.

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.

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 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é.
  • Enterprise — sur devis : volume sur mesure, conditions sur mesure, SLA contractuel.

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. Les tarifs sont disponibles en XAF, XOF, EUR et USD. Le paiement mobile money (Genuka Pay) couvre le XAF et le XOF ; le paiement par carte arrive.

Limites des forfaits

Trois limites chiffrées, toutes lisibles depuis l'API. Les fonctionnalités réservées (marque blanche, 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 sont encaissés par mobile money via Genuka Pay pour le XAF et le XOF. Le paiement par carte via Stripe arrive pour l'EUR et l'USD. Le mobile money n'a pas de mandat récurrent : chaque période est un nouvel encaissement, que vous déclenchez vous-même — nous ne prélevons jamais votre compte sans que vous validiez sur votre téléphone.

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.

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éthodeEndpointDescription
GET/api/v1/subscriptionVotre forfait actuel, ses limites, votre usage et la période de facturation.
GET/api/v1/invoicesVos 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.

Sur cette page