Skip to content
ABUNA
DocumentationJournal des modifications

Pour commencer

Journal des modifications

Ce qui a changé dans l'API Abuna, du plus récent au plus ancien.

Voir en Markdown

Tous les changements de l'API, du plus récent au plus ancien. Changements de l'API explique quels changements sont annoncés.

18 novembre 2026 : la page d'abonnement affiche le champ de code quand un code est utilisable

Modifié : les sessions checkout et les liens d'abonnement affichent Ajouter un code promo tant que votre application a au moins 1 code utilisable sur le prix. Avant, seule une session avec allow_promotion_codes: true l'affichait. Pour qu'une session ne prenne pas de code, envoyez allow_promotion_codes: false. Une session avec discounts n'a toujours pas de champ de code. Sur l'objet session, allow_promotion_codes vaut maintenant null pour une page d'abonnement qui ne l'a pas envoyé, y compris celles créées avant ce changement. Voir Laisser les clients taper le code.

13 novembre 2026 : prix en XOF et en USD

Nouveau : les applications et les prix peuvent être en XOF ou en USD, en plus du XAF. Les montants en USD sont en cents, donc 1000 vaut 10,00 $. Les clients paient toujours par mobile money en FCFA, dans la devise de leur réseau. Entre XOF et XAF, le montant se convertit 1 pour 1. Un montant en USD est débité au taux de change du jour plus 2 %, arrondi au franc supérieur, et les 2 % font partie de ce que vous recevez. Le client voit le montant en FCFA avant de valider le paiement, et les pages hébergées affichent les deux, comme 10,00 $ · 6 039 FCFA. Voir Paiement en FCFA.

Nouveaux champs sur l'objet payment : original_amount, original_currency, exchange_rate, exchange_margin_bps et exchange_rate_at. amount et currency indiquent toujours ce que le client a payé. Les paiements faits avant le 13 novembre 2026 ont ces cinq champs à null. invoice.paid et invoice.payment_failed portent désormais le paiement dans payment. Les amount et currency de la facture restent dans la devise du prix.

Nouvelle erreur : le paiement d'une facture en USD renvoie 503 avec le code exchange_rate_unavailable quand aucun taux de change récent n'est disponible. Rien n'est débité. Réessayez plus tard. Les changements de formule entre des prix de devises différentes sont toujours refusés avec price_not_eligible.

8 novembre 2026 : supprimer un client

Nouveau : DELETE /v1/apps/{appID}/customers/{id} supprime un client qui vous demande de supprimer ses données. Ses abonnements prennent fin comme si vous les aviez résiliés, et ses données personnelles sont effacées. Ses factures, ses paiements et leurs montants restent, donc vos totaux ne changent pas. Nouvel événement : customer.deleted. Quand vous le recevez, supprimez votre propre copie des données du client.

31 octobre 2026 : la page d'abonnement demande une messagerie avant le paiement

Modifié : quand votre application a WhatsApp ou Telegram activé, l'étape de paiement demande au client d'en connecter un, et il ne peut payer qu'une fois l'un activé. Cela remplace le choix sur l'écran de fin après le paiement, qui indique désormais seulement où vont les rappels. Un client dont les informations enregistrées comprennent une messagerie, ou qui reçoit déjà vos rappels sur l'une, n'a rien à refaire. Sans aucune messagerie activée, ou avec une session dont updates_channel vaut email, la page d'abonnement paie comme avant, avec des rappels par e-mail. Les essais gratuits proposent toujours les messageries une fois commencés. La première page de paiement d'un abonnement créé avec l'API demande aussi une messagerie. session.completed pour un abonnement payé arrive avec la messagerie déjà activée. Voir Où vont les rappels.

29 octobre 2026 : la page d'abonnement demande le numéro à l'étape de paiement

Modifié : la première étape de la page d'abonnement ne demande que l'e-mail du client, et son nom s'il le souhaite. L'étape de paiement demande le numéro de téléphone, et pour les numéros camerounais le réseau se déduit du numéro. Un customer.phone_number envoyé sur une session checkout devient le numéro de l'étape de paiement, et le client peut y choisir un autre numéro.

Un client venu par la page d'abonnement a désormais phone_number à null jusqu'à ce qu'il paie, c'est-à-dire la première facture après un essai gratuit. Son premier paiement réussi enregistre le numéro qui a payé et envoie customer.updated avec updated_by customer. Acceptez un numéro de téléphone à null, et prenez le numéro dans cet événement. Débiter une facture d'un client sans numéro de téléphone renvoie 422 phone_required. Voir Préremplissez le client.

29 octobre 2026 : les rappels se choisissent après le paiement

Modifié : la page d'abonnement ne demande plus où vont les rappels, ni ne confirme de numéro WhatsApp, avant le paiement. Une fois le premier paiement réussi, ou l'essai gratuit commencé, l'écran de fin propose les messageries de votre application, avec WhatsApp sur le numéro qui vient de payer. updates_channel définit désormais la messagerie affichée en premier, et email n'en propose toujours aucune. customer.updates_changed part aussi quand le client choisit sur cet écran. Voir Où vont les rappels.

29 octobre 2026 : le mode Test envoie ses codes par e-mail

Modifié : en mode Test, trois codes partent désormais par e-mail, comme en Production : le code qui démarre un essai gratuit, le code qui confirme une nouvelle adresse e-mail dans l'espace client et le code des informations enregistrées d'un client. Ils ont les mêmes limites qu'en Production. Tous les autres messages Test sont toujours enregistrés sans être envoyés. Les pages de code sont identiques à celles de Production et n'affichent plus le code.

Dans notification.captured, sent vaut désormais true pour ces codes, et un événement profile_code n'a pas de customer_id. En mode Test, la liste des messages contient désormais les codes d'essai gratuit et de changement d'adresse. Voir Mode Test.

19 octobre 2026 : messages WhatsApp selon le forfait

Modifié : avec le forfait Plus, WhatsApp transmet les messages liés au paiement des renouvellements : le code qui confirme le numéro, la facture de renouvellement, le dernier rappel avant la résiliation d'un abonnement impayé et les paiements échoués. Les forfaits Pro et Scale envoient aussi sur WhatsApp les rappels quotidiens, l'annonce d'un renouvellement, les reçus, les résiliations et les changements de formule. Avec le forfait Plus, ces messages partent par e-mail, et un client qui a écrit à Abuna sur WhatsApp dans les dernières 24 heures y reçoit quand même son reçu. En mode Test, tous les forfaits reçoivent tous les messages. Rien n'a changé dans l'API. Voir WhatsApp selon le forfait.

19 octobre 2026 : nouveaux textes, même API

Modifié : la documentation, le tableau de bord, les pages clients, les e-mails et les messages de chat présentent désormais Abuna comme la facturation récurrente pour l'écosystème mobile money, avec un seul mot pour chaque idée. Rien n'a changé dans l'API : les endpoints, les champs, les types d'événements, les codes d'erreur et le contenu des webhooks restent les mêmes.

Vos clients voient des textes plus courts et plus clairs dans les e-mails, sur les pages d'abonnement et de paiement, et sur Telegram. Les rappels WhatsApp ne changent pas.

16 octobre 2026 : clients qui reviennent sur la page d'abonnement

Modifié : un client qui revient sur une page d'abonnement avec l'e-mail de son abonnement en cours ne démarre plus un second abonnement au même produit. Seul l'e-mail compte, jamais le numéro de téléphone. Il retrouve son premier paiement impayé au même prix, ou il est refusé avec already_subscribed pour un prix qu'il paie déjà. Pour un autre prix du même produit, Abuna lui envoie par e-mail un lien pour changer de formule, et la page lui demande de consulter ses e-mails. Un abonnement impayé à un autre prix du produit reste tel quel.

Nouveau : les sessions checkout acceptent upgrade_timing, now ou next_renewal, pour choisir quand un passage à un prix supérieur prend effet, et l'objet session le renvoie. subscription.updated a les nouveaux types de changement upgrade_scheduled et upgrade_undone. Une session checkout qui change une formule se termine avec les champs du changement de formule et reste ouverte aussi longtemps que la proposition de changement de formule, jusqu'à 7 jours. Voyez Clients qui reviennent.

14 octobre 2026 : Paiements Abuna

Nouveau : une application en production peut encaisser sans compte de paiement à vous, avec Paiements Abuna. Abuna garde 3,5 % de chaque paiement réussi. Il vous verse le reste chaque jour à 8 h, heure du Cameroun, pour les paiements de la veille, par mobile money, dès que votre solde dépasse 100 FCFA. L'objet application a payments.abuna_payments, et les paiements ont net, ce que vous recevez d'un paiement passé par Paiements Abuna. Voyez Paiements Abuna.

10 octobre 2026 : choisissez vos événements webhook

Nouveau : l'URL de votre webhook ne reçoit que les types d'événements que vous choisissez dans le tableau de bord, avec un ensemble Recommandés pour une intégration standard. L'objet application a webhook_events, et GET /v1/event-types liste tous les types d'événements et ceux qui sont recommandés. Les URL de webhook que vous aviez déjà continuent de recevoir tous les types d'événements qu'elles recevaient. Voyez Choisissez vos événements.

9 octobre 2026 : les comptes de paiement appartiennent à votre équipe

Modifié : les comptes de paiement appartiennent désormais à votre équipe, et non plus à une seule application. Un propriétaire d'équipe connecte chaque compte une seule fois, sur la page Comptes de paiement de l'équipe, et toute application du même mode peut l'utiliser, avec une seule URL du webhook chez le prestataire pour toutes. Les comptes déjà connectés gardent leurs identifiants et leur URL du webhook. Voyez Connectez votre compte.

7 octobre 2026 : couleur d'accent des pages clients

Nouveau : l'objet application a branding.accent_color, la couleur que vos pages de paiement et d'abonnement et vos factures utilisent pour le bouton principal, les liens et les choix sélectionnés. Vous la définissez dans le tableau de bord.

6 octobre 2026 : copier les produits entre Test et Production

Nouveau : POST /v1/apps/{appID}/products/copy-from-test copie les produits et les prix d'une application, du mode Test vers le mode Production, et POST /v1/apps/{appID}/products/copy-from-live les copie de Production vers Test. Les copies sont liées dans les deux sens : copier à nouveau, dans un sens comme dans l'autre, les met à jour et n'en crée jamais de nouvelles. Nouveaux codes d'erreur : live_app_required, test_app_required et test_app_missing.

4 octobre 2026 : lancement

L'API Abuna est en ligne. Tout ce que décrit cette documentation est disponible en mode Test et en mode Production.

Étapes suivantes