Una notificación de compra anulada permite que tu servidor de Google Play revoque el acceso en el momento en que llega un reembolso

Un reembolso en Google Play no tiene por qué ser algo que descubras más tarde en un informe. Google Play puede enviar a tu servidor una notificación de compra anulada en el instante en que una compra se anula, ya sea que el comprador haya solicitado un reembolso de autoservicio, que un agente de soporte lo haya concedido, que un banco haya forzado un contracargo, o que tú mismo hayas reembolsado el pedido con la marca de revocación activada. El mensaje es diminuto, nombra la compra exacta y lleva una sola instrucción, devuelve el derecho de acceso, porque el dinero ya se ha ido.

Qué es realmente una notificación de compra anulada

Una notificación de compra anulada es un tipo de las Real-time Developer Notifications de Google Play, o RTDN. RTDN es un canal de tipo push. Google publica un mensaje en un tema de Cloud Pub/Sub de tu propiedad, y tu backend lo recibe pocos momentos después del evento, en lugar de enterarse en tu próximo sondeo programado. Ese es todo el sentido de la notificación de compra anulada frente a la antigua vía de sondeo: te enteras del reembolso a medida que ocurre, no horas después.

La vía de sondeo sigue existiendo y sigue importando. La Voided Purchases API permite que tu servidor pida, según tu propia planificación, la lista de compras que se anularon en un intervalo de tiempo. Las dos son complementarias. La notificación te avisa en el instante en que una compra cambia de estado; la API te permite conciliar en bloque y rellenar cualquier cosa que un mensaje perdido habría dejado atrás.

Viaja dentro de una Real-time Developer Notification

La notificación de compra anulada nunca llega por sí sola. Se encuentra dentro de un envoltorio DeveloperNotification, y ese envoltorio se entrega como una única cadena codificada en base64 en el campo data del mensaje de Pub/Sub. Tu controlador decodifica esa cadena a JSON antes de poder leer nada. El envoltorio siempre nombra la app y la hora del evento, y contiene exactamente un objeto de notificación de los cinco que define Google. Son mutuamente excluyentes, así que un mensaje que lleve un voidedPurchaseNotification no llevará también un evento de suscripción o de compra única.

Los cuatro campos que lleva

Quita el envoltorio y la notificación de compra anulada en sí son cuatro campos. Es deliberadamente escueta. La postura de Google es que, si lo único que necesitas es encontrar la compra correcta y ajustar el derecho de acceso, estos cuatro bastan, y no tienes que volver a llamar a ninguna API para actuar.

productType te dice qué se anuló

productType es un entero pequeño, y decide cuál de tus vías de revocación tomar. La anulación de una suscripción tiene que deshacer un acceso continuo; la anulación de una compra única solo elimina un único derecho de acceso.

refundType te dice cuánto se devolvió

refundType separa una reversión total limpia de una parcial. El caso parcial es acotado. Solo aparece cuando una compra única de varias unidades tuvo reembolsada parte, pero no toda, de su cantidad.

Actívala primero, o nunca llegará

Las notificaciones de compra anulada no fluyen de forma predeterminada. Habilitas RTDN una vez, en Play Console, y lo apuntas a un tema de Pub/Sub que tú controlas. El interruptor está en Monetize, luego Monetization setup, en la sección Real-time developer notifications, en la parte superior de la página. Marca Enable real-time notifications, luego pega el nombre completo de tu tema con el formato projects/{project_id}/topics/{topic_name}, y usa Send Test Message para confirmar que el conducto funciona antes de fiarte de él.

El selector de contenido es donde la gente pasa por alto las compras anuladas. Ambas opciones las incluyen, así que no puedes excluir por accidente los reembolsos mientras conservas las suscripciones.

• Recibir notificaciones para suscripciones y todas las compras anuladas. Recibes eventos de suscripción y toda compra anulada, pero no los eventos de compra de productos únicos.
• Recibir todas las notificaciones para suscripciones y productos únicos. Recibes lo anterior más los eventos de productos únicos como ONE_TIME_PRODUCT_PURCHASED y ONE_TIME_PRODUCT_CANCELED.

Lo que te cuesta, en dinero

Una anulación es una pérdida que ya está registrada para cuando la notificación te llega. El precio de venta se ha ido, y también todo lo que gastaste dando servicio a ese cliente. Si generó imágenes, ejecutó llamadas contra tus modelos, consumió almacenamiento o desencadenó un pago a un tercero, esos costes se pagaron con dinero real y no vuelven con el reembolso. La notificación no puede recuperar nada de eso. Lo que sí puede hacer es detener la hemorragia de aquí en adelante, que es toda la razón para actuar con rapidez.

La hemorragia es peor en las suscripciones y peor en los contracargos. Una suscripción que no revocas te sigue costando dar servicio, mes tras mes, por un cliente que ya no paga. Y un contracargo es el tipo de anulación más caro. A partir del 3 de agosto de 2026, la documentación de Google indica que un contracargo traslada al desarrollador el precio de compra más la comisión del banco. La notificación de compra anulada es con frecuencia el primer lugar donde tus propios sistemas se enteran de que un contracargo se ha completado, así que un controlador que revoca en el acto es lo que evita que una venta perdida se convierta en una venta perdida más semanas de servicio gratis.

Cómo gestionar una notificación de compra anulada, paso a paso

Verifica y elimina duplicados del mensaje

• Confirma que el mensaje de Pub/Sub procede de Google y apunta al tema que configuraste, luego decodifica el campo data en base64 para obtener el JSON de DeveloperNotification.
• Usa el messageId de Pub/Sub para descartar duplicados. Google advierte de que la misma notificación puede entregarse más de una vez, así que trata la reentrega como algo normal y haz que tu controlador sea idempotente.
• Confirma la recepción del mensaje solo después de haberlo registrado de forma segura, para que un fallo a mitad del controlador no pierda el evento.

Localiza la compra

• Empareja el purchaseToken con la compra que guardaste cuando concediste el derecho de acceso por primera vez. Recurre al orderId para búsquedas de soporte y conciliación manual.
• Lee productType para elegir la vía de revocación de suscripción o de compra única, y lee refundType para decidir entre una revocación total y una parcial.

Revoca y registra

• Elimina el derecho de acceso. Para un reembolso total, corta el acceso al artículo. Para un reembolso parcial basado en cantidad, reduce la cantidad concedida en la cantidad reembolsada y deja el resto intacto.
• Anota qué hiciste y cuándo, indexado por purchaseToken y orderId. Ese registro es lo que te permite responder un ticket de soporte más tarde, y lo que permite que la Voided Purchases API concilie de forma limpia contra tu propio estado.

Dónde encaja entre las demás señales de reembolso

Una notificación de compra anulada es un aviso, no una negociación. Te comunica un resultado que ya está decidido. Merece la pena verla junto a las señales con las que es fácil confundirla, porque solo algunas de ellas piden en algún momento tu versión de la historia.

La idea que hay que retener es simple. En ambas tiendas hay exactamente dos flujos de reembolso donde el desarrollador tiene voz, el CONSUMPTION_REQUEST de Apple y la revisión de contracargos de Google Play. Una notificación de compra anulada no es ninguno de los dos. Para cuando te llega, la decisión ya quedó atrás y lo único que queda en tus manos es la rapidez con la que revocas.