CONTRACARGOSGOOGLE PLAY

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.

Publicado el 6 min de lectura

Reembolsos y compras anuladas en Google Play: qué hacer con ellos

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.refund no puede reembolsar pedidos de más de tres años. Con revoke en 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 voidedSource en developer. En las suscripciones, recibes a la vez SUBSCRIPTION_REVOKED y una VoidedPurchaseNotification.
  • 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: 1 suscripción, 2 producto de compra única.
  • refundType: 1 reembolso total, 2 reembolso 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: startTime no puede ser anterior.
  • Por defecto solo devuelve productos de compra única. Pasa type=1 para incluir las suscripciones.
  • Cada registro tiene un voidedReason: 0 Other, 1 Remorse, 2 Not_received, 3 Defective, 4 Accidental_purchase, 5 Fraud, 6 Friendly_fraud, 7 Chargeback, 8 Unacknowledged_purchase.
  • Y un voidedSource: 0 usuario, 1 desarrollador, 2 Google.

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:

  1. Recuperar los artículos no usados, como la moneda de la app que se concedió.
  2. Avisos acumulativos: un aviso en la app para un primer caso, medidas más fuertes para los casos repetidos.
  3. Desactivar temporalmente las compras mientras lo investigas.
  4. Restringir el acceso a tu app en casos extremos y repetidos.
  5. 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 como SUBSCRIPTION_REVOKED y 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.

PROMPT

Read https://www.nochurn.sh/llms.txt,
then follow https://docs.nochurn.sh/quickstart/
to add NoChurn to this app. Use a test key
(nc_test_…) until I say we go live.

Deja de perder ingresos.

  • Gratis hasta 300 € de MRR
  • Sin tarjeta
  • Listo en 10 minutos
  • Sin comisión