# Journal des modifications > Ce qui a changé dans l'API Abuna, du plus récent au plus ancien. Source : https://abuna.app/docs/changelog?hl=fr Tous les changements de l'API, du plus récent au plus ancien. [Changements de l'API](https://abuna.app/docs/api-changes.md?hl=fr) 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](https://abuna.app/docs/api/sessions.md?hl=fr#object), `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](https://abuna.app/docs/guides/promotion-codes.md?hl=fr#checkout). ## 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](https://abuna.app/docs/amounts-currencies-and-timestamps.md?hl=fr#paying-in-fcfa). Nouveaux champs sur l'[objet payment](https://abuna.app/docs/api/invoices-and-payments.md?hl=fr#payment-object) : `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`](https://abuna.app/docs/api/events.md?hl=fr#invoice-paid) et [`invoice.payment_failed`](https://abuna.app/docs/api/events.md?hl=fr#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`](https://abuna.app/docs/errors.md?hl=fr#error-codes) 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}`](https://abuna.app/docs/api/customers.md?hl=fr#delete) 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`](https://abuna.app/docs/api/events.md?hl=fr#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](https://abuna.app/docs/guides/customer-notifications.md?hl=fr#reminder-channel). ## 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`](https://abuna.app/docs/api/events.md?hl=fr#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](https://abuna.app/docs/api/invoices-and-payments.md?hl=fr#charge) d'un client sans numéro de téléphone renvoie `422` `phone_required`. Voir [Préremplissez le client](https://abuna.app/docs/guides/sessions.md?hl=fr#prefill-the-customer). ## 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](https://abuna.app/docs/guides/customer-notifications.md?hl=fr#reminder-channel). ## 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`](https://abuna.app/docs/api/events.md?hl=fr#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](https://abuna.app/docs/api/notices.md?hl=fr) contient désormais les codes d'essai gratuit et de changement d'adresse. Voir [Mode Test](https://abuna.app/docs/guides/customer-notifications.md?hl=fr#test-mode). ## 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](https://abuna.app/docs/guides/plans-and-limits.md?hl=fr#whatsapp). ## 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](https://abuna.app/docs/api/sessions.md?hl=fr#returning-customers). ## 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](https://abuna.app/docs/api/apps.md?hl=fr#object) a `payments.abuna_payments`, et les paiements ont `net`, ce que vous recevez d'un paiement passé par Paiements Abuna. Voyez [Paiements Abuna](https://abuna.app/docs/guides/payment-providers.md?hl=fr#abuna-payments). ## 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](https://abuna.app/docs/api/apps.md?hl=fr#object) 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](https://abuna.app/docs/guides/webhooks.md?hl=fr#choose-events). ## 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](https://abuna.app/docs/guides/payment-providers.md?hl=fr#connect). ## 7 octobre 2026 : couleur d'accent des pages clients Nouveau : l'[objet application](https://abuna.app/docs/api/apps.md?hl=fr#object) 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`](https://abuna.app/docs/api/products.md?hl=fr#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`](https://abuna.app/docs/api/products.md?hl=fr#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.