Une notification d'achat annulé permet à votre serveur Google Play de révoquer l'accès dès qu'un remboursement est traité

Un remboursement sur Google Play n'a pas à être quelque chose que vous découvrez plus tard dans un rapport. Google Play peut envoyer à votre serveur une notification d'achat annulé dès l'instant où un achat est annulé, que l'acheteur ait effectué un remboursement en libre-service, qu'un agent d'assistance en ait accordé un, qu'une banque ait imposé une rétrofacturation, ou que vous ayez remboursé la commande vous-même avec l'indicateur de révocation activé. Le message est minuscule, il nomme l'achat exact, et il porte une seule instruction, rendre le droit d'accès, car l'argent est déjà parti.

Ce qu'est réellement une notification d'achat annulé

Une notification d'achat annulé est un type des Real-time Developer Notifications de Google Play, ou RTDN. La RTDN est un canal push. Google publie un message dans un topic Cloud Pub/Sub qui vous appartient, et votre backend le reçoit quelques instants après l'événement, au lieu de l'apprendre lors de votre prochaine interrogation planifiée. C'est tout l'intérêt de la notification d'achat annulé par rapport à l'ancienne voie de pull : vous apprenez le remboursement au moment où il se produit, pas des heures plus tard.

La voie de pull existe toujours et compte toujours. La Voided Purchases API permet à votre serveur de demander, selon votre propre calendrier, la liste des achats qui ont été annulés sur une plage de temps. Les deux sont complémentaires. La notification vous prévient dès l'instant où un achat bascule ; l'API vous permet de réconcilier en masse et de rattraper tout ce qu'un message manqué aurait laissé de côté.

Elle voyage à l'intérieur d'une Real-time Developer Notification

La notification d'achat annulé n'arrive jamais seule. Elle se trouve à l'intérieur d'un conteneur DeveloperNotification, et ce conteneur est livré sous la forme d'une unique chaîne encodée en base64 dans le champ data du message Pub/Sub. Votre gestionnaire décode cette chaîne en JSON avant de pouvoir lire quoi que ce soit. Le conteneur nomme toujours l'application et l'heure de l'événement, et il contient exactement un objet de notification parmi les cinq que Google définit. Ils sont mutuellement exclusifs, donc un message qui porte un voidedPurchaseNotification ne portera pas aussi un événement d'abonnement ou d'achat unique.

Les quatre champs qu'elle transporte

Retirez le conteneur et la notification d'achat annulé elle-même se réduit à quatre champs. C'est délibérément minimal. La position de Google est que si tout ce dont vous avez besoin est de retrouver le bon achat et d'ajuster le droit d'accès, ces quatre suffisent, et vous n'avez pas à rappeler une quelconque API pour agir.

productType vous indique ce qui a été annulé

productType est un petit entier, et il détermine laquelle de vos voies de révocation emprunter. L'annulation d'un abonnement doit défaire un accès continu ; l'annulation d'un achat unique retire simplement un seul droit d'accès.

refundType vous indique combien a été rendu

refundType distingue une annulation totale et nette d'une annulation partielle. Le cas partiel est étroit. Il n'apparaît que lorsqu'un achat unique à quantités multiples a vu une partie, mais pas la totalité, de sa quantité remboursée.

Activez-la d'abord, sinon elle n'arrive jamais

Les notifications d'achat annulé ne circulent pas par défaut. Vous activez la RTDN une fois, dans Play Console, et vous la pointez vers un topic Pub/Sub que vous contrôlez. L'option se trouve sous Monetize, puis Monetization setup, dans la section Real-time developer notifications en haut de la page. Cochez Enable real-time notifications, puis collez le nom complet de votre topic sous la forme projects/{project_id}/topics/{topic_name}, et utilisez Send Test Message pour confirmer que le canal fonctionne avant de vous y fier.

Le sélecteur de contenu est l'endroit où les gens ratent les achats annulés. Les deux choix les incluent, vous ne pouvez donc pas vous désinscrire accidentellement des remboursements tout en conservant les abonnements.

• Get notifications for subscriptions and all voided purchases. Vous recevez les événements d'abonnement et chaque achat annulé, mais pas les événements d'achat de produits uniques.
• Get all notifications for subscriptions and one-time products. Vous recevez ce qui précède plus les événements de produits uniques tels que ONE_TIME_PRODUCT_PURCHASED et ONE_TIME_PRODUCT_CANCELED.

Ce que cela vous coûte, en argent

Une annulation est une perte déjà comptabilisée au moment où la notification vous parvient. Le prix de la vente est parti, tout comme ce que vous avez dépensé pour servir ce client. S'il a généré des images, lancé des appels vers vos modèles, sollicité du stockage ou déclenché un versement à un tiers, ces coûts ont été payés en argent réel et ne reviennent pas avec le remboursement. La notification ne peut rien récupérer de tout cela. Ce qu'elle peut faire, c'est arrêter l'hémorragie à partir de maintenant, ce qui est toute la raison d'agir vite.

L'hémorragie est pire sur les abonnements et pire sur les rétrofacturations. Un abonnement que vous ne parvenez pas à révoquer continue de vous coûter à servir, mois après mois, pour un client qui ne paie plus. Et une rétrofacturation est le type d'annulation le plus coûteux. À compter du August 3, 2026, la documentation de Google indique qu'une rétrofacturation répercute sur le développeur le prix d'achat plus les frais de la banque. La notification d'achat annulé est fréquemment le premier endroit où vos propres systèmes apprennent qu'une rétrofacturation s'est conclue, donc un gestionnaire qui révoque sur-le-champ est ce qui empêche une vente perdue de se transformer en une vente perdue plus des semaines de service gratuit.

Comment traiter une notification d'achat annulé, étape par étape

Vérifiez et dédupliquez le message

• Confirmez que le message Pub/Sub provient de Google et vise le topic que vous avez configuré, puis décodez le champ data en base64 pour obtenir le JSON DeveloperNotification.
• Utilisez le messageId Pub/Sub pour écarter les doublons. Google avertit que la même notification peut être livrée plus d'une fois, alors traitez la re-livraison comme normale et rendez votre gestionnaire idempotent.
• N'accusez réception du message qu'après l'avoir enregistré en toute sécurité, afin qu'un plantage en cours de traitement ne perde pas l'événement.

Retrouvez l'achat

• Faites correspondre le purchaseToken avec l'achat que vous avez stocké lorsque vous avez octroyé le droit d'accès pour la première fois. Repliez-vous sur l'orderId pour les recherches d'assistance et la réconciliation manuelle.
• Lisez productType pour choisir la voie de révocation d'abonnement ou d'achat unique, et lisez refundType pour choisir entre une révocation totale et une révocation partielle.

Révoquez et enregistrez

• Retirez le droit d'accès. Pour un remboursement total, coupez l'accès à l'article. Pour un remboursement partiel basé sur la quantité, réduisez la quantité octroyée du montant remboursé et laissez le reste intact.
• Notez ce que vous avez fait et quand, indexé par purchaseToken et orderId. Cet enregistrement est ce qui vous permet de répondre à un ticket d'assistance plus tard, et ce qui permet à la Voided Purchases API de se réconcilier proprement avec votre propre état.

Où elle se situe parmi les autres signaux de remboursement

Une notification d'achat annulé est un avis, pas une négociation. Elle vous indique un résultat déjà décidé. Il vaut la peine de la voir aux côtés des signaux avec lesquels il est facile de la confondre, car seuls certains d'entre eux demandent un jour votre version de l'histoire.

La ligne à retenir est simple. Sur les deux boutiques, il existe exactement deux flux de remboursement où le développeur a voix au chapitre, le CONSUMPTION_REQUEST d'Apple et l'examen de rétrofacturation de Google Play. Une notification d'achat annulé n'est ni l'un ni l'autre. Au moment où elle vous parvient, la décision est derrière vous et la seule chose qui reste entre vos mains est la rapidité avec laquelle vous révoquez.