Los permisos de la cuenta de servicio de Google Play deciden quién puede reembolsar tus pedidos, así que concede el conjunto mínimo que funcione
Un solo permiso de Play Console permite a una cuenta de servicio reembolsar cualquier pedido y cancelar cualquier suscripción. Te explicamos qué permisos de la cuenta de servicio de Google Play necesita de verdad una herramienta de reembolsos, qué puede hacer una clave filtrada en cada tienda y cómo acotar, rotar y revocar las claves.

Puntos clave
- El permiso Manage orders and subscriptions (gestionar pedidos y suscripciones) de Google Play permite ver pedidos, reembolsarlos y cancelar suscripciones, así que cualquier cuenta de servicio que lo tenga puede devolver dinero a tus compradores.
- La guía de Google Play Developer API indica que las API de facturación de Google Play necesitan dos permisos de Play Console: View financial data, orders, and cancellation survey responses, y Manage orders and subscriptions.
- El método orders.refund de Google Play Developer API puede reembolsar cualquier pedido de compra única o suscripción de hasta 3 años de antigüedad y, con revoke en true, corta el acceso del comprador de inmediato.
- Las claves de cuentas de servicio de Google Cloud no caducan por defecto, y Google indica que una clave subida a un repositorio de código debe eliminarse en IAM, porque quitarla del repositorio no basta.
- La In-App Purchase key de Apple no puede emitir reembolsos, pero sí llamar a App Store Server API, incluidos los endpoints que amplían la fecha de renovación de una suscripción hasta 90 días, una ampliación que, según Apple, no se puede revertir.
- Solo un Account Holder o un Admin puede generar una In-App Purchase key en App Store Connect, la clave privada se descarga una sola vez y una clave revocada no se puede restablecer.
Dale a una cuenta de servicio dos permisos de Play Console y podrá reembolsar cualquier pedido de tu app. No es un error de configuración. Es exactamente como Google diseñó Google Play Developer API, y por eso la clave JSON que hay detrás de tu herramienta de reembolsos merece el mismo cuidado que el acceso a tu banco.
La mayoría de los equipos lo configura una sola vez, con prisas, marcando lo que hizo funcionar la primera llamada a la API. Esta guía va en sentido contrario. Detalla qué permisos de la cuenta de servicio de Google Play necesitan realmente los reembolsos y los contracargos, qué permite cada tienda hacer con una clave robada y cómo mantener acotado el radio de impacto.
Qué permiten realmente los permisos de la cuenta de servicio de Google Play
Una cuenta de servicio es un usuario robot. La creas en Google Cloud y luego invitas a su dirección de correo en Play Console, en Users and permissions (usuarios y permisos), igual que invitarías a un compañero. A partir de ahí puede hacer todo lo que esos permisos le permitan, a través de la API, a cualquier hora y sin segundo factor.
Los dos permisos que exigen las API de facturación
La guía de Google Play Developer API es concreta. Para usar las API de facturación de Google Play, concedes dos permisos: View financial data, orders, and cancellation survey responses (ver datos financieros, pedidos y respuestas a encuestas de cancelación), y Manage orders and subscriptions (gestionar pedidos y suscripciones). El primero permite a la cuenta leer pedidos y usar la API de compras. El segundo es el que toca el dinero.
| Permiso de Play Console | Lo que Google dice que permite | ¿Puede devolver dinero a los compradores? |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Ver informes financieros, informes de ventas y pedidos, acceder a la API de compras, descargar respuestas a encuestas de cancelación | No |
| Manage orders and subscriptions | Ver pedidos, reembolsar pedidos, cancelar suscripciones | Sí |
| Admin (todos los permisos) | Todos los demás permisos, además de invitar usuarios y cambiar sus permisos | Sí, y puede concederse más a sí misma |
Qué puede hacer una clave con derechos de reembolso
El método orders.refund de Google Play Developer API reembolsa el pedido de una suscripción o de una compra dentro de la app. Google indica que los pedidos de más de 3 años no se pueden reembolsar, lo que significa que todos los más recientes sí. Pon revoke en true y el acceso del comprador termina de inmediato. Para suscripciones, purchases.subscriptionsv2.revoke con reembolso completo hace lo mismo.
Son las herramientas adecuadas cuando quieres usarlas. Las propias recomendaciones antifraude de Google te dicen que reembolses y revoques una compra que no supera tus comprobaciones en lugar de dejar que caduque. El problema es una clave que puede hacer esto en todas las apps de tu cuenta cuando solo necesitaba una.
Lo que te puede costar una clave filtrada
Haz números antes de decidir cuánto esfuerzo merece esto. En Google Play, una clave con Manage orders and subscriptions puede reembolsar pedidos de uno en uno, y cada reembolso devuelve la venta al comprador. Un script no se cansa. El límite es tu historial de pedidos de los últimos 3 años.
Los costes que no vuelven con el reembolso
Un reembolso anula la venta. No anula lo que gastaste en atenderla. Ese gasto sigue en tus cuentas tanto si el reembolso lo pidió un cliente como si lo lanzó un atacante.
- Cómputo ya consumido: tiempo de GPU y de servidor detrás de cada generación, renderizado o respuesta de modelo que recibió el comprador.
- Llamadas a API ya pagadas: cargos por petición de proveedores de modelos, mapas, voz o datos.
- Almacenamiento que sigues pagando: los archivos y el historial que esas cuentas todavía guardan en tus servidores.
- Pagos ya enviados: los pagos a creadores, afiliados o vendedores ligados a esas compras no vuelven con el reembolso.
En Apple el riesgo tiene otra forma
App Store Server API de Apple no tiene ningún endpoint que emita reembolsos. Los reembolsos los decide Apple. Pero la misma In-App Purchase key puede ampliar la fecha de renovación de un suscriptor hasta 90 días, dos veces cada 365 días por cliente, o para todos los suscriptores activos de un producto en una sola petición masiva. Apple indica que una ampliación no se puede revertir. Durante esos días, al suscriptor no se le cobra y sigue usando tu app, así que tus facturas de cómputo, almacenamiento y API siguen corriendo sin ingresos.
| Lo que puede hacer una clave robada | Cuenta de servicio de Google Play con Manage orders and subscriptions | In-App Purchase key de Apple |
|---|---|---|
| Reembolsar un pedido | Sí, pedidos de hasta 3 años | No, solo Apple reembolsa |
| Cortar el acceso de un comprador | Sí, con revoke al reembolsar | No |
| Cancelar o ampliar suscripciones | Cancelar, sí | Ampliar fechas de renovación hasta 90 días, de forma irreversible |
| Leer datos de compras | Sí, con el permiso de visualización | Sí, historial de transacciones y reembolsos |
| Responder a revisiones de reembolso | Sí, orders.reviewrefund | Sí, Send Consumption Information |
| Limitarla a una app | Sí, mediante permisos de app | No, la clave funciona en todas las apps de tu equipo |
Cómo acotar los permisos de la cuenta de servicio de Google Play
Play Console separa los permisos de cuenta de los permisos de app. Los permisos de app solo se aplican a las apps que selecciones. Ese único ajuste hace más por tu seguridad que cualquier otra cosa de esta lista.
Concede en una app, no en toda la cuenta
Invita a cada cuenta de servicio con permisos de app en las apps a las que da servicio. Una herramienta de reembolsos para un juego no necesita derechos de reembolso en tu app de meditación. Ojo con una trampa: View financial data, orders, and cancellation survey responses solo existe a nivel de cuenta, y su equivalente a nivel de app se llama View financial data. Elige el de nivel de app al acotar.
Separa la lectura del reembolso
No todas las tareas necesitan Manage orders and subscriptions. Las analíticas que solo leen pedidos pueden funcionar con una cuenta que tenga permisos de visualización y nada más. Deja la clave capaz de reembolsar solo en el servicio que realmente llama a orders.refund, orders.reviewrefund o a los endpoints de revoke.
Nunca le des Admin a un robot
Admin concede todos los permisos, y Google incluye entre sus derechos invitar usuarios y gestionar sus permisos. Una clave Admin filtrada puede ampliar su propio acceso o invitar a alguien nuevo. Ningún flujo de reembolsos lo necesita.
Pregunta a los proveedores cómo se conectan
Algunas herramientas te piden subir una clave JSON. Otras te dan la dirección de su propia cuenta de servicio para que la invites, así ninguna clave tuya sale nunca de tu control y puedes retirarles el acceso desde Users and permissions con un clic. Si un proveedor necesita derechos de reembolso, pregunta qué permisos, en qué apps y por qué.

Cómo guardar, rotar y revocar las claves
Las dos tiendas dicen lo mismo con otras palabras. No pongas claves en un repositorio de código ni las incluyas en tu app. Las diferencias están en lo que ocurre cuando algo sale mal.
Las claves de Google Cloud no caducan solas
Las recomendaciones de Google Cloud señalan que las claves de cuentas de servicio no tienen fecha de caducidad por defecto. Recomiendan rotarlas de forma periódica y desactivar las que ya no uses. Si una clave acaba en un repositorio, Google dice que la elimines en IAM lo antes posible, porque borrarla del repositorio no basta. Google Cloud también puede desactivar automáticamente las claves filtradas que detecte cuando la restricción Service Account Key Exposure Response está configurada en DISABLE_KEY, pero no garantiza detectar todas las filtraciones.
Las claves de Apple se descargan una vez y se revocan para siempre
Solo un Account Holder o un Admin puede generar una In-App Purchase key. Apple guarda la parte pública, tú descargas el archivo privado .p8 una sola vez y Apple no conserva copia. Si sospechas que una clave está comprometida, Apple indica que la revoques de inmediato en App Store Connect, en Users and Access, Integrations, In-App Purchase. Una clave revocada no se puede restablecer, y revocarla también impide canjear las ofertas promocionales firmadas con ella, así que actualiza esas ofertas antes o justo después.
| Tarea | Cuenta de servicio de Google Play | In-App Purchase key de Apple |
|---|---|---|
| Quién puede crearla | Se crea en Google Cloud y luego se invita en Users and permissions de Play Console | Account Holder o Admin |
| ¿Se puede volver a descargar el secreto? | Creas una clave nueva | No, una sola descarga |
| Caducidad por defecto | Ninguna | Ninguna, hasta que la revoques |
| Cómo cortar el acceso rápido | Eliminar la clave en IAM o quitar la cuenta en Play Console | Revocar la clave en App Store Connect |
| Efectos secundarios de cortar el acceso | Cualquier herramienta que use esa cuenta deja de llamar a la API | Las ofertas promocionales firmadas con ella dejan de canjearse |
Una lista de comprobación breve
- Una cuenta de servicio por tarea, invitada con permisos de app solo en las apps a las que da servicio.
- Manage orders and subscriptions solo en la cuenta que de verdad reembolsa, revoca o responde a revisiones.
- Ningún Admin en ninguna cuenta robot.
- Claves en un gestor de secretos, nunca en un repositorio, un log de compilación ni una app móvil.
- Una lista escrita de cada clave, quién la creó y qué servicio la usa, para que una revocación no rompa tus respuestas de reembolso.
- Una revisión de Users and permissions en Play Console y de las claves de App Store Connect cada vez que alguien deja el equipo o se prescinde de un proveedor.
Preguntas frecuentes
- ¿Qué permisos de Play Console necesita una cuenta de servicio para reembolsos y contracargos?
- Necesita Manage orders and subscriptions para reembolsar pedidos, cancelar suscripciones y trabajar con pedidos, además de acceso de lectura a los pedidos. La guía de Google Play Developer API indica View financial data, orders, and cancellation survey responses y Manage orders and subscriptions como los dos permisos que requieren las API de facturación de Google Play.
- ¿Puede una cuenta de servicio de Google Play reembolsar pedidos?
- Sí, si tiene el permiso Manage orders and subscriptions. La página de ayuda de Google dice que ese permiso permite ver pedidos, reembolsarlos y cancelar suscripciones, y el método orders.refund de la API reembolsa cualquier pedido de hasta 3 años de antigüedad.
- ¿Puede alguien con mi In-App Purchase key de App Store reembolsar a mis clientes?
- No. App Store Server API no tiene endpoint de reembolso, porque los reembolsos los decide Apple. Aun así, una clave robada puede leer el historial de transacciones y reembolsos, enviar información de consumo y ampliar la fecha de renovación de las suscripciones hasta 90 días, algo que según Apple no se puede revertir.
- ¿Caducan las claves de cuentas de servicio de Google Play?
- No por defecto. Las recomendaciones de Google Cloud indican que las claves que creas y descargas no tienen fecha de caducidad salvo que la configures, y aconsejan rotarlas de forma periódica y desactivar las que ya no uses.
- ¿Qué hago si subí a GitHub la clave JSON de mi cuenta de servicio?
- Elimina la clave en IAM de Google Cloud de inmediato y crea una nueva. Google dice que quitarla del repositorio no basta, porque cualquiera que la haya copiado puede seguir usándola hasta que se elimine la propia clave.
Fuentes y lecturas adicionales
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
El piloto automático de reembolsos para App Store y Google Play
Seguir leyendo
Brasil ya vigila qué juegos siguen vendiendo cajas de botín a menores, y la factura llega con los reembolsos de cajas de botín
El ministerio de justicia de Brasil pidió a la autoridad de protección de datos que vigile seis juegos que venden cajas de botín sin verificar la edad. Esto es lo que exige la ley, lo que Apple y Google ya piden y cómo valorar y gestionar los reembolsos de cajas de botín cuando la caja ya está abierta.
Las compras in-app accidentales son los reembolsos que no puedes ganar, así que la solución está en tu pantalla de compra
Las compras in-app accidentales vuelven como reembolsos en ambas tiendas, y ningún dato de uso demuestra que un toque fuera intencionado. Así las etiquetan Apple y Google, esto es lo que cada una te cuesta en cómputo y pagos, y este es el diseño de pantalla de compra que las frena antes de que exista el cargo.