Skip to content
ABUNA
DocumentationForfaits et limites

Guides

Forfaits et limites

Ce que chaque forfait Abuna comprend, et ce qui se passe quand vous dépassez une limite.

Voir en Markdown

Cette page présente ce que permet chaque forfait Abuna et ce qui se passe quand votre équipe atteint une limite. Le forfait de votre équipe fixe son nombre d'abonnés, d'applications et de membres. Chaque équipe a son propre forfait, et vous pouvez posséder autant d'équipes que nécessaire.

Seul le mode Production compte dans une limite. Le mode Test est gratuit et illimité avec tous les forfaits. Créer une application occupe quand même l'une des applications de l'équipe, car chaque application a un mode Production et un mode Test.

Forfaits

  • Free (free) : 0 FCFA. 20 abonnés, 1 application partagée par toutes les équipes au forfait Free que vous créez, et 2 membres par équipe.
  • Plus (plus) : 3 000 FCFA par mois ou 30 000 FCFA par an. 150 abonnés, 3 applications par équipe, et 10 membres par équipe.
  • Pro (pro) : 9 900 FCFA par mois ou 99 000 FCFA par an. 1 000 abonnés, et aucune limite d'applications ou de membres.
  • Scale (scale) : 25 000 FCFA par mois ou 250 000 FCFA par an. Aucune limite.

Les prix incluent la TVA. Une année coûte le prix de dix mois, et vous payez en FCFA par mobile money. Les propriétaires d'équipe changent le forfait dans le tableau de bord, sous Forfait et utilisation pour cette équipe.

Avec le forfait Free, votre page d'abonnement, vos liens de paiement, votre espace client et vos e-mails clients affichent « Facturation par Abuna ». Les forfaits payants ne l'affichent pas.

À partir du forfait Plus, vous pouvez aussi envoyer des messages WhatsApp et des rappels quotidiens en mode Production. Le mode Test permet les deux avec tous les forfaits.

WhatsApp selon le forfait

Avec le forfait Plus, WhatsApp transmet les messages liés au paiement des renouvellements :

  • Le code qui confirme le numéro du client
  • La facture de renouvellement, avec son lien de paiement
  • Le dernier rappel avant la résiliation d'un abonnement impayé
  • Un message quand un paiement échoue

Les forfaits Pro et Scale envoient aussi tous les autres messages sur WhatsApp : les rappels quotidiens, l'annonce d'un renouvellement, les reçus, et les messages sur les changements de formule et les résiliations. Avec le forfait Plus, ces messages partent par e-mail.

Avec le forfait Plus, un client qui a écrit au numéro WhatsApp d'Abuna dans les dernières 24 heures, par exemple pour renouveler depuis la discussion, y reçoit quand même son reçu.

En mode Test, tous les forfaits reçoivent tous les messages : vous pouvez essayer ce que Pro ajoute.

Ce qui compte dans une limite

  • Abonnés : les clients qui ont un abonnement en cours ou impayé en mode Production, ou dont le premier paiement est en cours. Un client compte une fois, quel que soit le nombre d'abonnements qu'il détient dans la même application. Le décompte couvre toutes les applications de l'équipe. L'API appelle cette limite live_subscribers.
  • Applications : les applications d'une équipe. Chaque application compte une fois, avec ses modes Production et Test. Avec le forfait Free, les applications de toutes vos équipes au forfait Free comptent ensemble.
  • Membres : les personnes d'une équipe. Une invitation en attente occupe aussi une place.

L'application du forfait Free est partagée

Le forfait Free inclut une application par personne, et non par équipe. Vous pouvez créer autant d'équipes que vous voulez. Tant qu'une de vos équipes au forfait Free a une application, vos autres équipes au forfait Free ne peuvent pas en créer. Chaque application a un mode Production et un mode Test : elle utilise donc l'application du forfait Free, même si vous ne travaillez qu'en mode Test.

Une équipe peut passer au forfait Free, ou y revenir quand son forfait n'est pas renouvelé, alors qu'une autre de vos équipes au forfait Free a déjà une application. Cette équipe dépasse alors ses limites comme n'importe quelle autre. Vous recevez des e-mails d'avertissement, et après 14 jours ses applications passent en lecture seule en mode Production.

Rien n'est supprimé, et votre application la plus ancienne parmi vos équipes au forfait Free reste modifiable. Pour régler cela, passez l'une des deux équipes à un forfait payant. Une équipe payante peut avoir plusieurs applications : l'autre équipe peut donc garder la sienne ou en créer une.

Quand vous atteignez une limite

Abuna refuse tout ce qui vous ferait dépasser votre forfait. Rien de ce que vous avez déjà n'est supprimé. La requête renvoie 403 avec le code plan_limit :

Réponse 403 plan_limit
{
  "code": "plan_limit",
  "error": "the free plan allows no more live_subscribers; plus does",
  "limit": "live_subscribers",
  "plan": "free",
  "plan_needed": "plus"
}
  • limit est ce qui est épuisé : live_subscribers, apps, ou members.
  • plan est le forfait dont les limites s'appliquent maintenant.
  • plan_needed est le plus petit forfait qui en autorise un de plus.

À la limite d'abonnés, vous ne pouvez pas créer d'abonnement pour un nouveau client, et le premier paiement d'un nouveau client est refusé. Les clients que vous comptez déjà ne sont jamais refusés : les renouvellements passent, et un abonné actuel peut démarrer un autre abonnement.

Les clients ne voient jamais votre forfait. Quand un nouveau client tente de s'abonner sur votre page d'abonnement ou de payer un lien de paiement alors que vous êtes à la limite, il voit que vous n'acceptez pas de nouveaux abonnés pour le moment, et que rien n'a été débité. La requête renvoie 403 avec le code seller_at_capacity :

Réponse 403 seller_at_capacity
{
  "code": "seller_at_capacity",
  "error": "the seller takes no new subscribers"
}

Créer une application dans une équipe au forfait Free alors qu'une autre de vos équipes au forfait Free en a une renvoie 403 avec le code free_app_used. La réponse nomme cette équipe :

Réponse 403 free_app_used
{
  "code": "free_app_used",
  "error": "the Free plan's app is already used in team team_01J8Z; plus for this team allows one here",
  "limit": "apps",
  "plan": "free",
  "plan_needed": "plus",
  "team_id": "team_01J8Z",
  "team_name": "Amina's shop"
}

team_id et team_name désignent l'équipe qui détient l'application du forfait Free. Pour créer l'application, passez l'une des deux équipes à un forfait payant. Sinon, continuez d'utiliser l'application de l'équipe qui l'a.

Passer à un forfait plus petit

Si vous ne renouvelez pas un forfait payant, il continue de fonctionner 14 jours après la date jusqu'à laquelle il est payé. Ensuite, les limites du forfait Free s'appliquent. Si vous passez à un forfait payant plus petit, ses limites s'appliquent dès que son premier paiement passe.

Dans les deux cas, rien n'est supprimé. Les applications en trop dans cette équipe restent modifiables en mode Production 14 jours après votre changement, puis passent en lecture seule. Quand un forfait impayé arrive à échéance, elles passent en lecture seule à ce moment-là.

Les applications les plus anciennes de l'équipe restent modifiables, autant que le forfait le permet. Les autres équipes ne sont pas touchées, sauf les équipes au forfait Free qui partagent l'application du forfait Free.

Quand une application est en lecture seule en mode Production :

  • Vous pouvez toujours tout lire.
  • Les autres modifications renvoient 403 avec le code plan_read_only.
  • Les clients peuvent toujours payer, les renouvellements continuent, et vous pouvez toujours débiter une facture via l'API.
  • Vous pouvez toujours révoquer des clés d'API et renouveler votre clé publiable et votre secret de signature de webhook.
  • Son mode Test reste modifiable.
Réponse 403 plan_read_only
{
  "code": "plan_read_only",
  "error": "this is beyond the free plan's apps, so it is read-only; plus covers it",
  "limit": "apps",
  "plan": "free",
  "plan_needed": "plus"
}

Pour les rendre de nouveau modifiables, passez au forfait indiqué dans plan_needed.

Étapes suivantes