KappS Base de conocimiento · Blog

Google Play Reembolsos y contracargos en 2026

Blog Guía

Google Play cambió sus reglas de reembolso para desarrolladores el 3 de agosto de 2026: no la parte que ven los usuarios, sino la que decide quién paga cuando una compra se convierte en disputa. Ahora los costos de contracargo se comparten, y una nueva API te permite defender tu posición ante un contracargo antes de que se resuelva. Si tu app vende suscripciones o desbloqueos de pago único y nunca has revisado tu flujo de compras anuladas, este es el trimestre para corregirlo.

A continuación, la secuencia operativa: qué dice realmente el reparto de costes, cómo distinguir un reembolso de un contracargo en Play Console, la única fuente de datos de pedidos que ve los contracargos del procesador y la ventana de 24 horas que decide cuánto de una disputa asumes.

Tres cifras deciden la exposición: 3 de agosto de 2026: los pedidos realizados después de esta fecha entran en el nuevo reparto de costes de contracargos. 24 horas: el tiempo que tienes para responder a una PendingRefundReviewNotification mediante la API de revisión de reembolsos. 30 días: el periodo máximo de consulta retrospectiva de la API de compras anuladas, y la única fuente de datos de pedidos que incluye compras contracargadas por los procesadores de pago.

1. Qué cambió el 3 de agosto

La página de ayuda de Play Console Actualizaciones sobre la protección de reembolsos y la responsabilidad de los costes de contracargo expone el cambio con claridad: Google Play evitó US$3.4B de fraude y abuso en 2025, está añadiendo más salvaguardas y detección de fraude en 2026 para reducir el abuso de reembolsos y, para alinearse con los estándares del sector, empezará a compartir los costes de contracargo con los desarrolladores en los pedidos realizados después del 3 de agosto de 2026.

El reparto es concreto. Un contracargo es una disputa que el usuario abre directamente con su banco o emisor de la tarjeta, no con Play. Cuando ocurre:

  • Desarrollador: el precio de la compra (menos la comisión de servicio de Play) más las comisiones por contracargo que cobra la entidad financiera.
  • Google Play: sigue cubriendo la comisión de servicio de esa transacción.

Así que una venta en disputa ya no es neutra en ingresos para ti. Devuelves lo que cobraste y asumes una comisión bancaria por disputa, mientras que Google renuncia a su propia comisión. El importe devuelto depende de tu nivel de comisión por servicio, que Google documenta en Comisiones por servicio, y ese documento también cambió: para las transacciones con usuarios del EEE, el Reino Unido o EE. UU. a partir del 30 de junio de 2026, la comisión depende de si la instalación del usuario se clasifica como nueva o existente (las suscripciones de renovación automática se tratan por separado, y el primer US$1M de ingresos anuales se sitúa en el nivel más bajo). Antes de modelar el coste de una oleada de contracargos, confirma en qué nivel está realmente tu cuenta.

2. Cuatro eventos distintos se ven idénticos en tus informes de ingresos

La documentación de la API de compras anuladas enumera qué puede anular una compra, y no son en absoluto el mismo evento:

  • el usuario solicita el reembolso de su pedido;
  • el usuario cancela su pedido;
  • el pedido se contracarga;
  • el desarrollador cancela o reembolsa el pedido;
  • Google cancela o reembolsa el pedido.

Esa API cubre los pedidos únicos dentro de la app y las suscripciones de la app, y viene con una advertencia que conviene leer dos veces: a diferencia de otras fuentes de datos relacionadas con pedidos, incluye compras revertidas por los procesadores de pago, así que deberías esperar inconsistencias entre esta API y otros datos de pedidos. Los informes financieros y tu sistema de derechos legítimamente no coinciden aquí: saberlo de antemano es lo que evita una falsa alarma.

De la misma página se derivan dos mecánicas. Solo se devuelven los pedidos revocados: si reembolsas una compra sin activar la opción de revocación, el pedido no aparecerá en la API en absoluto. Y algunas compras se reembolsan porque el desarrollador nunca confirmó la compra, lo que significa que el pedido reembolsado puede que ni siquiera exista en tus propios registros.

3. Paso 1 — clasifica el pedido en Play Console

Gestiona los pedidos de tu app y emite reembolsos es donde aparecen los movimientos de dinero, y las etiquetas de estado marcan la distinción que ahora cuesta dinero:

  • Reembolso pendiente — un reembolso solicitado aún no procesado.
  • Reembolsado — con dos variantes que importan: Este reembolso lo pagó Google y Este reembolso fue un contracargo.
  • Reembolso parcial pendiente / Reembolsado parcialmente: para importes parciales.

La variante de contracargo es la cara: el dinero se fue porque el usuario acudió a su banco, no porque tú aprobaras nada. La misma página también confirma que puedes emitir reembolsos totales o parciales de compras dentro de la app y de apps de pago por tu cuenta, que es la vía más económica cuando un usuario está insatisfecho y aún es localizable.

4. Paso 2 — conecta la API de compras anuladas

Este es el flujo que te permite reaccionar, y sus limitaciones están documentadas con precisión:

  • Endpoint: GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/purchases/voidedpurchases, authorised with an OAuth client or service account that holds the View financial reports permission.
  • Periodo de consulta: como máximo los últimos 30 días. Las compras anuladas más antiguas no se devuelven independientemente del startTime que envíes; el valor predeterminado es hace 30 días.
  • Paginación: maxResults tiene un valor predeterminado de 1000 y el máximo también es 1000; un nextPageToken continúa la lista. Sigue usando tokens de continuación en lugar de aumentar el tamaño de página.
  • Suscripciones: type=0 devuelve solo compras dentro de la app; type=1 añade las compras de suscripción, y en cuanto solicites suscripciones debes cambiar a orderId en la respuesta, porque una vista solo de suscripciones devuelve varios pedidos que comparten un mismo purchaseToken.
  • Reembolsos parciales: includeQuantityBasedPartialRefund=true añade reembolsos parciales basados en cantidad que llevan un voidedQuantity. Cuando la cantidad restante se reembolsa finalmente, ese registro no tiene voidedQuantity: esa ausencia es la señal documentada de una compra de varias unidades totalmente reembolsada.

Una sutileza que rompe las uniones ingenuas por ventana temporal: los registros se filtran por cuándo vio la API que el pedido quedó anulado, no por el valor voidedTimeMillis que devuelve la respuesta. Un proceso que se ejecuta mensualmente y pierde una ejecución descarta registros sin avisar, porque la ventana nunca se amplía. Prográmalo con más frecuencia que la ventana, deduplica por orderId o purchaseToken y trata la respuesta como una señal de revocación, no como un libro contable completo.

5. Paso 3 — responde al contracargo en 24 horas

La guía de Google AyudaGoogle para disputar contracargos describe el nuevo flujo y tiene un tiempo limitado:

  1. Atento a la notificación. Cuando un usuario inicia un contracargo que requiere revisión del desarrollador, Play envía la notificación en tiempo real para desarrolladores PendingRefundReviewNotification. La referencia de RTDN la incluye como campo de primer nivel de DeveloperNotification, mutuamente excluyente con voidedPurchaseNotification y con las notificaciones de productos de un solo uso, suscripciones y pruebas.
  2. Reúne las pruebas y responde en un plazo de 24 horas tras recibir la notificación llamando a la API de reembolso de revisión. Debes indicar una preferencia de reembolso y pruebas del uso de la compra: el estado de entrega del pedido y si el artículo se consumió.
  3. Conoce la regla de un solo intento. Play registra la primera llamada a la API hecha en respuesta a una notificación e ignora las posteriores, aunque siga devolviendo un estado OK. Una integración que se dispara dos veces no se corrige con un segundo intento, y una carga útil mal asignada no se puede arreglar a posteriori.

La API de reembolso de reseñas se describe como opcional: Google no te obliga a responder. Pero cuando asumes el precio de compra y la comisión bancaria, el silencio se convierte en la opción cara, y el plazo de 24 horas implica que la integración debe existir antes de que llegue la primera notificación. Es el mismo patrón que las notificaciones de desarrollador en tiempo real en general: un webhook o una suscripción Pub/Sub en funcionamiento y probados son el requisito previo, no una tarea posterior.

6. Paso 4: prueba el proceso de contracargo antes de necesitarlo

Google documenta un flujo de prueba para contracargos iniciados por el usuario en la guía de pruebas de Play Billing, que es la única forma fiable de confirmar tres cosas: que tu suscriptor de RTDN recibe realmente una PendingRefundReviewNotification, que tu controlador la asocia al pedido y al token de compra correctos, y que tu llamada de revisión de reembolso tiene éxito con una compra de prueba. Mantén el controlador idempotente y registra la primera respuesta, ya que solo cuenta la primera llamada. Confirma el flujo de notificaciones de principio a fin: una suscripción configurada pero nunca ejercitada no es un control.

7. Paso 5 — entiende qué efecto tienen los reembolsos en tu pago

La página de gestión de pedidos también detalla la mecánica del efectivo, y es peor de lo que parece:

  • Reembolso antes del pago → el importe no se incluye en tu próximo pago.
  • Reembolso después del pago → el importe se descuenta de un pago futuro.
  • Si tu saldo queda en negativo y sigue así durante al menos 48 horas, Google cobra los fondos de acuerdo con los Términos del servicio y debita de la cuenta bancaria que normalmente recibe tus pagos el importe del saldo negativo a fecha del día en que se inicia el débito.

La lectura práctica: una acumulación de contracargos en un mes de bajos ingresos no solo reduce un pago, sino que puede sacar dinero de tu cuenta bancaria. Las cuentas con ingresos volátiles o con un patrón estacional de picos y caídas deberían vigilar esta cifra a propósito en lugar de descubrirla como un cargo.

8. Paso 6 — ten en cuenta las 48 horas de cara al usuario

La documentación para usuarios de Google explica por qué las disputas llegan a los bancos. Más información sobre las políticas de reembolso de Google Play señala que las políticas de reembolso varían según el producto, el método de pago y la región, que la mayoría de las apps de Play las crean desarrolladores externos y que el desarrollador puede procesar reembolsos conforme a sus propias políticas y a la legislación aplicable, con la recomendación directa de que contactar con el desarrollador suele ser la vía más rápida para resolver un problema. Solicitar un reembolso en Google Play indica a los usuarios que contacten con el desarrollador cuando quieran un reembolso y hayan pasado más de 48 horas desde la compra. Los usuarios del EEE y del Reino Unido tienen una vía aparte para las compras realizadas a partir del 28 de marzo de 2018.

La conclusión operativa no tiene nada de glamuroso: tu página de política de reembolsos y una dirección de soporte accesible son infraestructura de prevención de contracargos. Un usuario que no puede contactarte en los dos primeros días es un usuario cuyo siguiente paso es su banco, y a partir del 3 de agosto de 2026 ese camino es el que te cuesta el precio más una comisión.

9. Qué no hacer

  • No revoques de forma masiva ante la primera señal. La API de compras anuladas está documentada como una indicación de cuándo tomar medidas adicionales, y la propia guía de Google exige una política de revocación justa y transparente: avisa a los usuarios cuando revoques el acceso a un producto dentro de la app, dales tiempo para entender los cambios de política antes de que entren en vigor y permíteles impugnar tus decisiones.
  • No emitas un reembolso sin la opción de revocación y esperes que tu sistema lo detecte. Solo los pedidos revocados aparecen en la API.
  • No trates la API como un libro contable. Incluye contracargos del procesador que otras fuentes de pedidos omiten y excluye reembolsos que nunca se reconocieron desde el principio.
  • No lo ejecutes con una programación igual de larga que su ventana. Una ventana de 30 días y una tarea mensual no dejan margen para una sola ejecución fallida.

¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.

Haz clic para elegir un archivo · clic derecho → Pegar, o pulsa Ctrl/⌘+V para pegar una captura de pantalla

También puedes arrastrar un archivo a este cuadro.

Respondemos al correo que nos proporciones. Tus datos se quedan con KappS.

✔ Enviado

Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.


← Volver a editar