Guides
Messages aux clients
Ce que vos clients reçoivent par e-mail, Telegram et WhatsApp, et à quel moment.
Abuna envoie à vos clients les messages sur leur abonnement à votre place : ce qu'ils doivent payer, ce qu'ils ont payé, et quand leur formule prend fin. Vous n'avez aucun de ces messages à écrire ni à envoyer.
Chaque message part par e-mail. Il peut aussi partir sur Telegram ou sur WhatsApp, si le client en choisit un. Telegram est activé par défaut, avec tous les forfaits. WhatsApp reste désactivé tant que vous ne l'activez pas, et demande le forfait Plus ou supérieur en mode Production.
Les messages sont en français ou en anglais, selon la langue du client. Un client sans langue définie les reçoit en français. Les montants et les dates suivent la langue : 5 000 FCFA et 4 oct. 2026 en français, FCFA 5,000 et 4 Oct 2026 en anglais.
Ce que reçoivent les clients
Chaque message a un kind, indiqué ici entre parenthèses. L'API Notices utilise les mêmes noms.
- Abonnement démarré (
subscription_started) : 30 minutes après la création d'un abonnement, si la première période n'est pas encore payée. Il demande au client de payer la première période et renvoie vers le lien de paiement. Un client qui paie sur la page d'abonnement ne reçoit que le reçu. En mode Test, il est enregistré dès la création de l'abonnement. - Paiement reçu (
payment_received) : un reçu, après chaque paiement réussi. Quand le paiement met en vigueur une mise à niveau, le reçu indique aussi que la formule a changé. Pour une facture que vous avez marquée payée, il indique que vous avez enregistré le paiement. - Paiement échoué (
payment_failed) : quand un paiement échoue après que le client a quitté la page de paiement, avec la raison. Par exemple, il ne l'a jamais validé sur son téléphone. Un refus que le client voit sur la page de paiement n'envoie rien. Le client en reçoit au plus un par heure pour la même facture. - Renouvellement à venir (
renewal_upcoming) : quand la facture de renouvellement part avant la fin de la période payée, 3 jours avant par défaut. Il contient le montant dû, la date limite de paiement et le lien de paiement, et le client peut payer tout de suite. Avec les rappels quotidiens activés et Facture de renouvellement à 0, ou avec une rétrogradation programmée, il part 3 jours avant la fin de la période sans lien de paiement. Il indique alors que le lien arrivera le jour du renouvellement. - Renouvellement dû (
subscription_renewed) : quand une facture de renouvellement part au début de sa période, avec le montant dû et un lien de paiement. Il demande au client de payer pour renouveler sa formule. - Rappel de paiement (
payment_overdue) : une fois par jour tant qu'un renouvellement est impayé, avec les rappels quotidiens activés. - Dernier rappel (
payment_final_notice) : 1 jour avant la résiliation d'un abonnement impayé, avec les rappels quotidiens activés. Avec 1 jour pour payer, il part au milieu de cette journée. - Abonnement qui prend fin (
subscription_cancel_scheduled) : quand vous ou le client programmez une résiliation à la fin de la période payée. Il indique la date de fin de l'abonnement et comment le garder. - Abonnement maintenu (
subscription_cancel_undone) : quand une résiliation programmée est retirée. Une courte confirmation. - Abonnement résilié (
subscription_canceled) : quand l'abonnement prend fin. C'est immédiat quand vous ou le client résiliez tout de suite, à la fin de la période payée pour une résiliation programmée, ou quand il reste impayé. Un premier abonnement jamais payé prend fin sans message. - Changement de formule proposé (
plan_change_offered) : quand vous proposez une autre formule au client depuis le tableau de bord, et chaque fois que vous la renvoyez. Il indique le montant de la nouvelle formule après la réduction éventuelle du client, et renvoie vers la page où il l'accepte. Une session de changement de formule ne l'envoie pas. - Changement de formule demandé (
plan_switch_requested) : quand un client choisit, sur une page d'abonnement, un autre prix du produit auquel il est abonné. Il renvoie vers la page où il confirme le changement ; rien ne change tant qu'il ne l'a pas fait. Il part uniquement par e-mail. Voir Changer de formule depuis la page d'abonnement. - Formule mise à niveau (
plan_upgraded) : quand une mise à niveau prend effet, avec la nouvelle formule et la nouvelle date de facturation. Si la nouvelle période reste à payer, il contient le montant dû et le lien de paiement. Une mise à niveau qui prend effet quand le client paie envoie le reçu à la place, pour qu'il ne reçoive qu'un message. - Mise à niveau à payer (
plan_upgrade_due) : quand une mise à niveau attend que le client paie le reste de la nouvelle formule, avec le montant, la date limite de paiement et le lien de paiement. Il indique que le client garde sa formule s'il ne paie pas. Si la mise à niveau a remplacé une résiliation programmée, il indique que l'abonnement prend quand même fin à sa date. Rien n'est envoyé quand la mise à niveau expire. - Rétrogradation programmée (
plan_downgrade_scheduled) : quand une rétrogradation est fixée pour la fin de la période payée, avec la nouvelle formule et sa date de début. - Rétrogradation retirée (
plan_downgrade_undone) : quand vous ou le client retirez une rétrogradation programmée. Il indique que le client garde sa formule, avec la prochaine date de facturation et son montant. - Changement de prix (
price_change_scheduled) : quand vous programmez un nouveau montant pour un prix et que les abonnés actuels y passeront, avec le montant qu'ils paieront, après leur réduction éventuelle, et la date à laquelle il s'applique pour la première fois. Les clients sont prévenus au moins 14 jours à l'avance. Les clients qui s'abonnent pendant que le changement est en attente le reçoivent au moment de leur abonnement. - Changement de prix retiré (
price_change_canceled) : quand vous retirez ce changement, ou le remplacez par un autre qui garde les abonnés actuels sur l'ancien montant. Il indique que leur prix ne change pas. - Code de vérification (
email_code) : quand le client change son adresse e-mail dans l'espace client. Il part par e-mail, uniquement vers la nouvelle adresse, avec un code à 6 chiffres. Son e-mail change quand il saisit ce code dans l'espace client, dans les 15 minutes. - Coordonnées modifiées (
contact_changed) : quand le client change son adresse e-mail ou son numéro de téléphone dans l'espace client. Il part vers son ancienne adresse e-mail et sa conversation Telegram connectée, jamais vers la nouvelle adresse. Il montre la nouvelle adresse en partie masquée. - Liens de l'abonnement (
portal_links) : quand un client demande les liens vers ses abonnements sur votre page. Il part uniquement par e-mail, au plus une fois toutes les 5 minutes.
Les e-mails viennent de <nom de votre application> via Abuna, et les réponses du client arrivent à votre e-mail d'assistance. Chaque e-mail se termine par votre e-mail d'assistance ou votre page d'aide, et un lien vers l'espace client. Tant que le client n'a pas connecté Telegram, il contient aussi un lien pour recevoir les mêmes messages là-bas.
Les e-mails sur un abonnement terminé, les liens de l'abonnement et les codes de vérification n'ont pas les liens vers l'espace client et Telegram. Quand vous définissez vos propres conditions, le pied de page y renvoie. Avec le forfait Free, le pied de page indique aussi Facturation par Abuna. Définissez votre e-mail d'assistance et vos conditions dans le tableau de bord, sous Paramètres, Général, Assistance client.
Les dates et les heures s'affichent dans le fuseau horaire de votre application. Les nouvelles applications démarrent à l'heure du Cameroun. Changez-le sous Paramètres, Général, Fuseau horaire.
Quand partent les rappels
Les renouvellements sont facturés à l'avance : la nouvelle période commence à la date de renouvellement, même si le client paie en avance. Réglez les deux valeurs ci-dessous sous Paramètres, Général, Renouvellements et délai de paiement.
- Facture de renouvellement : combien de jours avant la fin de la période payée la facture part. 3 par défaut, de 0 à 7, et jamais avant la moitié de la période. Le client peut la payer dès ce moment.
- Jours pour payer : vous choisissez combien de jours vos clients ont pour payer, de 1 à 14, à compter de la date de renouvellement. Si un renouvellement reste impayé au-delà, Abuna résilie l'abonnement et prévient le client. Les nouvelles applications démarrent à 3.
Par défaut, le client reçoit deux messages par renouvellement :
- Quand la facture de renouvellement part, avec son lien de paiement : 3 jours avant la fin de la période payée, ou à la date de renouvellement avec Facture de renouvellement à 0.
- Si elle est toujours impayée à la fin de votre délai de paiement, Abuna résilie l'abonnement et prévient le client.
Les reçus et les messages de paiement échoué partent normalement en plus.
Rappels quotidiens
Activez les Rappels quotidiens sous Paramètres, Général, Messages aux clients pour rappeler aux clients de payer chaque jour jusqu'au paiement. En plus des deux messages ci-dessus :
- Chaque jour après la date de renouvellement, tant que la facture est impayée, le client reçoit un rappel.
- 1 jour avant la résiliation, il reçoit un dernier rappel à la place.
- Avec Facture de renouvellement à 0, il reçoit aussi un avis 3 jours avant la fin de la période, sans lien de paiement.
Par exemple, avec 3 jours pour payer, cela donne un rappel 1 jour après la date de renouvellement, le dernier rappel à 2 jours et la résiliation à 3 jours. Avec 1 jour pour payer, le dernier rappel part 12 heures avant la résiliation.
Les rappels quotidiens sont désactivés pour les nouvelles applications. En mode Production, ils demandent le forfait Plus ou supérieur ; avec le forfait Free, les applications en production n'envoient que les deux messages. En mode Test, ils fonctionnent avec tous les forfaits, pour que vous puissiez essayer les deux calendriers. Un client qui paie, ou dont l'abonnement prend fin, ne reçoit plus de rappel.
Tant qu'une application en production ne peut pas encaisser de paiements, par exemple sans prestataire de paiement connecté, les factures de renouvellement et les rappels attendent, et aucun abonnement n'est résilié pour non-paiement. Une fois que l'application encaisse de nouveau, le client reçoit le rappel prévu à ce moment-là, avec le lien de paiement.
Où vont les rappels
L'e-mail part toujours. Quand votre application a WhatsApp ou Telegram activé, l'étape de paiement demande au client d'en connecter un sous Rappels de paiement avant de payer. Payer reste désactivé tant qu'aucun n'est connecté : chaque client qui paie à l'abonnement reçoit ses rappels sur son téléphone. Elle ne propose chaque messagerie que si votre application l'a activée.
Un client n'a qu'une messagerie à la fois : connecter WhatsApp déconnecte Telegram, et connecter Telegram déconnecte WhatsApp.
- Le client saisit ses coordonnées et passe à l'étape de paiement.
- Un client qui choisit WhatsApp confirme son numéro WhatsApp avec un code. Voir WhatsApp.
- Un client qui choisit Telegram appuie sur Activer les rappels Telegram. Telegram s'ouvre dans un nouvel onglet, où il appuie sur Démarrer. Le bot confirme, et l'étape de paiement affiche Telegram comme activé à son retour.
- Le client paie. L'écran de fin indique où vont ses rappels, puis l'envoie vers votre URL de retour après paiement au bout de quelques secondes.
Un client dont les informations enregistrées comprennent WhatsApp ou Telegram, ou qui reçoit déjà vos rappels sur l'un d'eux, n'a rien à refaire : l'étape de paiement indique où vont ses rappels et lui permet de changer. Une messagerie connectée en enregistrant ses informations est enregistrée avec elles, pour son prochain abonnement auprès de toute entreprise sur Abuna.
Quand votre application n'a aucune messagerie activée, la page ne demande rien : les clients paient et reçoivent leurs rappels par e-mail. Un essai gratuit ne demande rien non plus avant de commencer : son écran de fin propose vos messageries, et le client peut s'en passer. Un abonnement que vous créez avec l'API demande, lui, une messagerie : sa première page de paiement en exige une avant le paiement.
Après l'abonnement, le client peut activer ou désactiver WhatsApp ou Telegram, passer de l'un à l'autre, ou choisir l'e-mail uniquement, sous Rappels de paiement dans son espace client. L'espace client le prévient avant qu'il désactive une messagerie.
Activez ou désactivez chaque messagerie pour toute l'application dans le tableau de bord, sous Paramètres, Général, Messages aux clients. Tant qu'elle est désactivée, la page d'abonnement ne la propose pas et ses messages s'arrêtent pour tous les clients. Ils reçoivent toujours les e-mails.
En mode Production, Telegram fonctionne avec tous les forfaits, Free compris, et WhatsApp demande le forfait Plus ou supérieur. En mode Test, tous les forfaits peuvent utiliser les deux.
Pour choisir la messagerie que l'étape de paiement affiche en premier, envoyez updates_channel quand vous créez la session. whatsapp affiche WhatsApp en premier, telegram affiche Telegram en premier, email ne propose aucune messagerie et envoie l'e-mail uniquement, et ask, la valeur par défaut, affiche les messageries de votre application dans l'ordre habituel. Si votre application ne peut pas proposer le canal envoyé, la page s'ouvre quand même et fonctionne comme ask.
curl https://api.abuna.app/v1/apps/8ddhXCDW/sessions \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6f1c2b9e-4d3a-4c8e-9a7f-2e5b8d1c0a43" \
-d '{
"type": "checkout",
"price_id": "Zt6YbN3q",
"customer": {"email": "ana@example.com"},
"success_url": "https://example.com/welcome",
"updates_channel": "telegram"
}'Chaque client a un objet updates avec le statut de son Telegram et de son WhatsApp : off, active ou stopped. Telegram peut aussi être pending tant que le client ne l'a pas activé, et WhatsApp peut être failed. WhatsApp n'est jamais pending : il passe à active dès que le client confirme son numéro et le choisit.
L'objet ne contient jamais d'identifiant de conversation ni de numéro de téléphone. Chaque changement envoie un événement customer.updates_changed, et l'événement session.completed de la page d'abonnement porte les mêmes updates.
Tant que Telegram est pending, son connect_url est un lien qui l'active : affichez-le dans votre application comme un bouton Activer les rappels. Il vaut null dans tous les autres statuts.
Accordez l'accès depuis les webhooks, pas depuis la page de retour
Un client peut fermer l'onglet avant d'arriver sur votre URL de retour après paiement. N'accordez pas l'accès quand le client arrive sur cette page. Accordez-le quand subscription.paid arrive à l'URL de votre webhook, et prolongez-le à chaque invoice.paid.
Abuna envoie les deux une fois le paiement réussi, que le client soit revenu ou non. Voir Webhooks pour savoir comment les vérifier.
// Inside the verified webhook handler from the Webhooks guide.
if (event.type === "subscription.paid") {
// The first payment went through, whether or not the customer came back to your site.
const { subscription, customer_id } = event.data;
await grantAccess(subscription.metadata.user_id, subscription.id, customer_id);
}
if (event.type === "invoice.paid") {
// Every payment, renewals included. Extend the access you gave.
await extendAccess(event.data.subscription_id);
}Telegram
Telegram est activé par défaut pour toutes les applications, avec tous les forfaits. Chaque e-mail contient un lien Recevoir les messages de votre abonnement sur Telegram. Quand le client l'ouvre et appuie sur Démarrer, le bot d'Abuna connecte sa conversation.
À partir de là, chaque message part à la fois vers son e-mail et son Telegram. Les liens de l'abonnement partent toujours uniquement par e-mail. Le client peut aussi renouveler directement depuis la conversation, en validant le paiement sur son téléphone.
- Chaque lien fonctionne une seule fois. Une fois une conversation connectée, les e-mails ne portent plus le lien, pour qu'un e-mail transféré ne puisse pas envoyer les messages du client vers la conversation de quelqu'un d'autre. L'espace client l'affiche toujours.
- Seules les conversations privées peuvent se connecter. Une conversation de groupe montrerait les liens de paiement d'un client à tout le monde.
- Si le client connecte un autre compte Telegram, les messages y passent, et l'ancienne conversation en est informée.
- Le client peut envoyer
arrêtoustopau bot à tout moment, en majuscules ou en minuscules. Les messages partent alors uniquement par e-mail, et aucun message en attente ne part sur Telegram. Son statut Telegram devientstoppedjusqu'à ce qu'il le réactive.
WhatsApp est facultatif et désactivé pour les nouvelles applications. Activez-le dans le tableau de bord, sous Paramètres, Général, Messages aux clients. En mode Production, il demande le forfait Plus ou supérieur ; en mode Test, il fonctionne avec tous les forfaits.
La facture de renouvellement, le dernier rappel avant la résiliation d'un abonnement impayé et les paiements échoués arrivent toujours sur WhatsApp. Avec les forfaits Pro et Scale, les rappels quotidiens, l'annonce d'un renouvellement, les reçus, les résiliations et les changements de formule y arrivent toujours aussi. Avec le forfait Plus, ces messages partent uniquement par e-mail, sauf le reçu d'un client qui a écrit à Abuna sur WhatsApp dans les dernières 24 heures. Voir WhatsApp selon le forfait.
Les autres messages, comme un changement de prix, n'arrivent sur WhatsApp que si le client y a écrit à Abuna dans les dernières 24 heures. Les liens de l'abonnement partent uniquement par e-mail. L'e-mail part toujours pour chaque message, donc un client sans WhatsApp ne rate rien.
Les messages WhatsApp partent du numéro WhatsApp d'Abuna et nomment votre application et la formule du client. Par exemple, la facture de renouvellement dit « Ici Abuna. Votre formule Premium chez Mboa se renouvelle le 15 mars 2026. Payez 5 000 FCFA avant le 14 mars 2026, 18:00 pour la garder. » avec un bouton Renouveler. Le client peut renouveler directement depuis la conversation, en validant le paiement sur son téléphone.
- Une fois le paiement fait, ou l'essai gratuit commencé, le client choisit WhatsApp sur l'écran de fin de la page d'abonnement. Le champ du numéro WhatsApp commence avec le numéro avec lequel il vient de payer, et il peut en utiliser un autre.
- Il reçoit un code à 6 chiffres sur WhatsApp et le saisit sur la page.
- Une fois le numéro confirmé, son WhatsApp passe à
activetout de suite, et il poursuit vers votre URL de retour après paiement comme n'importe quel client.
Tant que le numéro n'est pas confirmé, WhatsApp n'est pas activé et les rappels partent par e-mail. Le client confirme le numéro chaque fois qu'il le choisit, sauf le numéro sur lequel il reçoit déjà ses rappels.
Un code est valable 10 minutes et permet 5 essais erronés. Le client peut demander un nouveau code une fois par minute, jusqu'à 5 fois par jour pour le même numéro.
- Le client peut changer de numéro, passer à Telegram ou arrêter WhatsApp dans son espace client. Un nouveau numéro se confirme avec un code, comme sur la page d'abonnement.
- Le client peut envoyer
stopouarrêtdans la conversation WhatsApp à tout moment. Son statut WhatsApp devientstopped, et les rappels partent par e-mail jusqu'à ce qu'il confirme de nouveau le numéro dans son espace client. L'arrêt vaut pour le numéro : il arrête aussi les rappels WhatsApp des autres applications qui utilisent Abuna. - Si WhatsApp ne peut pas livrer au numéro, le statut devient
failedet les rappels partent par e-mail. Le client peut saisir un autre numéro dans son espace client. - Chaque changement de son statut WhatsApp envoie un événement
customer.updates_changed.
Mode Test
Les clients en mode Test ont souvent de vraies adresses e-mail et de vraies conversations, donc le mode Test n'envoie que les codes par e-mail dont un client a besoin pour aller au bout de vos pages, comme en production :
- Le code qui démarre un essai gratuit sur la page d'abonnement (
trial_email_code). - Le code qui confirme une nouvelle adresse e-mail dans l'espace client (
email_code). Il va à la nouvelle adresse. - Le code des informations enregistrées d'un client sur la page d'abonnement (
profile_code).
Ils ont les mêmes limites qu'en production : un code par minute et cinq par heure pour chaque adresse e-mail. Chaque code est valable 15 minutes. Ils vont à l'adresse saisie sur la page, donc utilisez une adresse que vous pouvez lire, ou une adresse inventée.
Aucun autre message n'est envoyé. Abuna enregistre chaque message, envoyé ou non, comme un événement notification.captured, avec son sujet et son texte. sent vaut true pour les trois codes par e-mail et false pour les autres. Ces événements ne vont pas à l'URL de votre webhook.
Avec une adresse inventée, lisez le code dans le sujet de l'événement. Listez les événements pour vérifier votre parcours :
curl "https://api.abuna.app/v1/apps/8ddhXCDW/events?type=notification.captured" \
-H "Authorization: Bearer sk_test_..."{
"id": "01J9ZQ8E1F2G3H4J5K6M7N8P9Q",
"type": "notification.captured",
"environment": "test",
"created_at": 1727600000,
"data": {
"customer_id": "Cu5tM8rA",
"kind": "payment_received",
"channel": "email",
"recipient": "ana@example.com",
"subject": "Receipt from My store: FCFA 5,000 paid",
"text": "...",
"sent": false
}
}Vérifiez ce qui a été envoyé
En mode Production, listez vos messages avec GET/v1/apps/{appID}/notices. Filtrez par subscription_id ou par status : pending, sending, sent, failed ou withdrawn. En mode Test, la liste ne contient que les codes d'essai gratuit et de changement d'e-mail.
curl "https://api.abuna.app/v1/apps/Q7mKp2Rt/notices?subscription_id=x9QbL2sK" \
-H "Authorization: Bearer sk_live_..."Un message qui ne peut pas être livré finit en failed. Voir Notices pour chaque champ.
E-mails à votre équipe
En mode Production, les membres de votre équipe reçoivent leurs propres e-mails quand un abonnement démarre, qu'un paiement est reçu, qu'un paiement échoue, qu'un abonnement est résilié, ou qu'un client change de formule. Programmer une résiliation pour la fin de la période payée, ou la retirer, compte comme une résiliation. Un changement de formule, c'est une mise à niveau qui prend effet, ou une rétrogradation programmée ou retirée.
Chaque membre choisit les e-mails qu'il veut, et s'ils arrivent tout de suite ou une fois par jour, sous Notifications dans son profil. Un premier paiement ou une mise à niveau payée donne un seul e-mail, pas deux. Les e-mails à l'équipe sont en anglais.
Un e-mail de paiement échoué ne part que si le client n'a pas vu l'échec sur la page de paiement, par exemple quand un paiement échoue après qu'il l'a quittée. Un échec que le client voit sur la page de paiement n'envoie aucun e-mail, ni à lui ni à votre équipe.
Un renouvellement encore impayé à la fin de sa période payée, donc un abonnement past_due, apparaît dans le résumé quotidien de chaque membre qui a choisi Un paiement échoue, même s'il reçoit ses autres e-mails tout de suite.