Reembolsos y compras anuladas en Google Play: qué hacer con ellos
Reembolsos, revocaciones y contracargos en las suscripciones de Google Play: notificaciones de compras anuladas, la Voided Purchases API y las revisiones.

En Google Play, el dinero puede volver a un suscriptor de varias formas: el usuario obtiene un reembolso, tú le reembolsas desde Play Console o la API, una compra nunca se confirma o el pago es objeto de un contracargo. Google agrupa todo esto bajo un solo término: una compra anulada (voided purchase). Si concedes acceso o créditos desde tu propio backend, necesitas conocer cada una de ellas.
Esta guía explica dónde aparecen las compras anuladas, qué te dice Google de cada una, la revisión de reembolsos más reciente para los contracargos y cómo responder. Se ciñe a la documentación de Google: la referencia de las notificaciones de desarrollador en tiempo real, las buenas prácticas de seguridad sobre compras anuladas, gestionar las compras rechazadas, el ciclo de vida de las suscripciones y la referencia de la Google Play Developer API sobre las compras anuladas, orders.refund y orders.reviewrefund (todas consultadas en noviembre de 2026).
Qué cuenta como compra anulada
La página de seguridad de Google define las compras anuladas como “compras que se han cancelado, revocado o que han sido objeto de un contracargo”, y enumera las causas principales:
- La compra la cancela el usuario, el desarrollador o Google, incluidas las compras canceladas automáticamente porque nunca se confirmaron. En las suscripciones, esto significa cancelar la propia compra, no solo desactivar la renovación.
- La compra es objeto de un contracargo.
- El desarrollador cancela o reembolsa un pedido y marca la opción “revocar”.
Una cancelación normal de suscripción (el usuario detiene la renovación) no es una compra anulada. Es un evento SUBSCRIPTION_CANCELED, y el usuario conserva el acceso hasta el final del periodo.
Reembolsar, revocar o ambas cosas
Tienes tres acciones, y hacen cosas distintas:
| Acción | API | Dinero | Acceso |
|---|---|---|---|
| Solo reembolsar | orders.refund sin revoke |
Reembolsado | Se mantiene |
| Reembolsar y revocar | orders.refund con revoke=true, o purchases.subscriptionsv2.revoke con un reembolso total |
Reembolsado | Termina de inmediato |
| Cancelar | purchases.subscriptionsv2.cancel |
No reembolsado | Se mantiene hasta el final del periodo |
Puntos de la documentación de Google que conviene conocer:
orders.refundno puede reembolsar pedidos de más de tres años. Conrevokeen true, el acceso termina de inmediato y, en una suscripción recurrente, se detienen todos los pagos futuros.- La guía de integración de Google dice que las revocaciones del desarrollador y los reembolsos con revocación desencadenan notificaciones y aparecen en la Voided Purchases API con
voidedSourceen developer. En las suscripciones, recibes a la vezSUBSCRIPTION_REVOKEDy unaVoidedPurchaseNotification. - Un reembolso sin revocación “no desencadena una notificación de revocación ni de compra anulada”. Si lo usas, regístralo tú mismo.
- Si no confirmas una nueva suscripción en tres días, el usuario recibe automáticamente un reembolso y la compra se revoca. Google pide que no te apoyes en esto para rechazar compras: revoca y reembolsa de forma explícita.
Dónde aparecen las compras anuladas
En tiempo real: VoidedPurchaseNotification
Si tu app de Play tiene activadas las notificaciones de desarrollador en tiempo real, una compra anulada llega como una voidedPurchaseNotification con:
purchaseToken: la compra que se anuló.orderId: el pedido exacto. En las suscripciones, cada renovación tiene su propio ID de pedido, así que esto te dice qué pago se anuló.productType:1suscripción,2producto de compra única.refundType:1reembolso total,2reembolso parcial por cantidad (solo compras de varias unidades).
Google señala que esto basta para “localizar la compra y el pedido correctos para ajustar los derechos de acceso”. En las suscripciones, una revocación también envía una notificación de suscripción SUBSCRIPTION_REVOKED; la guía del ciclo de vida dice que en ese caso revoques de inmediato el derecho de acceso del usuario.
En bloque: la Voided Purchases API
purchases.voidedpurchases.list es una API de consulta. Según la referencia de la API:
- Cubre los últimos 30 días:
startTimeno puede ser anterior. - Por defecto solo devuelve productos de compra única. Pasa
type=1para incluir las suscripciones. - Cada registro tiene un
voidedReason:0Other,1Remorse,2Not_received,3Defective,4Accidental_purchase,5Fraud,6Friendly_fraud,7Chargeback,8Unacknowledged_purchase. - Y un
voidedSource:0usuario,1desarrollador,2Google.
Los códigos de motivo son lo más útil, porque la notificación no los incluye. Una salvedad de la página de seguridad: las compras anuladas “sin ningún contenido de recuperación asociado no se exponen en la Voided Purchases API”.
Usa las dos: la notificación para actuar en segundos, y una consulta diaria a la API para obtener los motivos y recoger lo que se te haya escapado.
Contracargos: la revisión de reembolsos
Google ha añadido una forma de que los desarrolladores opinen sobre algunos contracargos. Cuando un usuario solicita un contracargo que necesita la revisión del desarrollador, recibes una pendingRefundReviewNotification. Según la referencia de RTDN, debes evaluar la solicitud y enviar “una sugerencia de reembolso y pruebas de uso de la compra en 24 horas” llamando a orders.reviewrefund. Las revisiones pendientes solo admiten de momento CHARGEBACK como motivo.
El cuerpo de la petición, según la referencia de la API:
| Campo | Significado |
|---|---|
pendingRefundToken |
De la notificación; obligatorio |
refundPreference |
APPROVE, DECLINE o NEUTRAL; obligatorio |
sampleContentProvided |
Si ofreciste una muestra gratuita, una prueba o una descripción antes de la compra; obligatorio |
consumptionPercentageMilliunits |
Opcional, de 0 a 100.000 (45.200 significa 45,2%) |
consumptionUsageEvents |
Lista opcional de eventos de uso (hora, descripción del artículo, dirección IP, ubicación, ID de cuenta o de perfil ofuscado); las listas de más de 1.000 elementos se rechazan |
La notificación incluye el obfuscatedAccountId y el obfuscatedProfileId si los fijaste en la compra. Sin ellos, te costará encontrar el uso del usuario en 24 horas.
Sé sincero. Si el usuario no pudo usar lo que pagó, APPROVE es la respuesta correcta. Si usó la suscripción durante todo el periodo, un DECLINE con eventos de uso concretos es para lo que sirve el campo.
Qué hacer con cada compra anulada
La guía de seguridad de Google recomienda, según el motivo y el historial del usuario:
- Recuperar los artículos no usados, como la moneda de la app que se concedió.
- Avisos acumulativos: un aviso en la app para un primer caso, medidas más fuertes para los casos repetidos.
- Desactivar temporalmente las compras mientras lo investigas.
- Restringir el acceso a tu app en casos extremos y repetidos.
- Llamar más a menudo a la Voided Purchases API cuando detectes compras anuladas.
Para una app de suscripción, una política práctica sería así:
| Motivo | Respuesta sugerida |
|---|---|
| Compra accidental, arrepentimiento | Terminar el acceso del periodo reembolsado; sin aviso. Quizá pedir feedback |
| No recibido, defectuoso | Tratarlo como un error del producto; investigar la cuenta del usuario |
| Compra no confirmada | Arreglar tu procesamiento de compras; es un error tuyo, no del usuario |
| Fraude, friendly fraud, contracargo | Terminar el acceso, marcar la cuenta, bloquear nuevas compras hasta revisarla |
Errores frecuentes
- Tratar solo
SUBSCRIPTION_CANCELED. Significa “dejar de renovar”, no “reembolsado”. Las revocaciones llegan comoSUBSCRIPTION_REVOKEDy notificaciones de compra anulada. - Reembolsar sin revocar y olvidarlo. Ninguna notificación te lo recordará.
- Consultar la API menos de una vez al mes. Todo lo que tenga más de 30 días desaparece de la API.
- Sin ID de cuenta ofuscado. No puedes responder a tiempo a una revisión de reembolso si no puedes encontrar al usuario.
- Castigar los reembolsos por arrepentimiento como si fueran fraude. Los códigos de motivo existen para que puedas distinguirlos.
Hacerlo con NoChurn
NoChurn lee tus notificaciones de desarrollador en tiempo real de Google Play y la Voided Purchases API, así que los reembolsos, las revocaciones y los contracargos aparecen en la cronología de cada cliente con su motivo y alimentan la puntuación de churn. En Google Play, los reembolsos son de solo lectura en NoChurn: las decisiones de reembolso y las revisiones de reembolsos siguen en tus manos y las de Google, y los pagos y los reintentos siguen en Google. Para asociar las compras a los clientes, fija un ID de cuenta ofuscado en la compra. Consulta NoChurn + Google Play.