Skip to main content
Un abonnement facture un client à intervalle régulier — chaque semaine, chaque mois, chaque année — pour un ou plusieurs produits. Yabetoo génère la facture de chaque cycle, demande le paiement au client sur son numéro Mobile Money, relance en cas d’échec et vous notifie par webhook à chaque étape.

​
Le modèle

​
Ce qui se passe à chaque cycle

1

Trois jours avant l'échéance

Yabetoo émet la facture du cycle à venir et l’envoie par e-mail au client, avec un lien de paiement. Le client peut la régler à l’avance.
2

Le jour de l'échéance, à 11 h (Brazzaville)

Si la facture n’est pas encore payée, une demande de paiement est poussée sur le numéro Mobile Money par défaut du client. Il l’approuve sur son téléphone.
3

Succès

La facture passe paid, vous recevez invoice.paid, la période avance.
4

Échec

L’abonnement passe past_due, et trois relances automatiques partent à J+1, J+3 et J+7. Voir Paiements échoués.
Mobile Money n’a pas de prélèvement automatique. Un renouvellement ne se débite pas : il se demande, et le client doit l’approuver sur son téléphone. C’est pour cela que la demande part à 11 h heure locale, jamais la nuit, et que l’échec d’un renouvellement est un cas nominal à gérer — pas une exception.

​
Deux façons de créer un abonnement

Par l'API

Vous connaissez le client et son numéro Mobile Money : un appel à POST /v1/subscriptions crée l’abonnement et demande le premier paiement.

Par la page de paiement hébergée

Le client choisit et paie lui-même sur pay.yabetoo.com, via une session de checkout en mode subscription ou un lien de paiement.

​
Environnements

Il n’y a qu’un seul hôte. Le mode est porté par la clé : une sk_test_ travaille en mode test (isLive: false, les paiements partent vers l’environnement de test de Yabetoo Pay), une sk_live_ en mode live. Les données des deux modes sont séparées, mais servies par la même API et visibles dans le même tableau de bord (bascule test/live). Le mode d’un abonnement (test ou live) est celui de la clé qui l’a créé, et il est figé : toute sa facturation suit ce mode. Pour simuler le passage du temps en test, utilisez les horloges de test.

​
Ce que le système ne fait pas

Pour ne pas le découvrir en production :
  • Pas de changement de prix sur un abonnement existant. Seule la quantité d’une ligne se modifie (PUT /v1/subscriptions/{id}/quantity). Pour changer d’offre : annuler et recréer.
  • Pas d’annulation automatique après les relances : un abonnement impayé reste past_due jusqu’à ce que vous le régularisiez ou l’annuliez.
  • Pas de crédit automatique sur une baisse de quantité en cours de période.
  • Pas d’e-mail automatique au client pour un échec de paiement, une annulation ou une fin d’essai : seules les factures sont envoyées par e-mail.