Todos los artículos
Guía práctica8 min de lectura

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.

Una llave de latón sobre un escritorio oscuro junto a un portátil y un teléfono, en representación de los permisos de la cuenta de servicio de Google Play que controlan los reembolsos

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 ConsoleLo que Google dice que permite¿Puede devolver dinero a los compradores?
View financial data, orders, and cancellation survey responsesVer informes financieros, informes de ventas y pedidos, acceder a la API de compras, descargar respuestas a encuestas de cancelaciónNo
Manage orders and subscriptionsVer pedidos, reembolsar pedidos, cancelar suscripcionesSí
Admin (todos los permisos)Todos los demás permisos, además de invitar usuarios y cambiar sus permisosSí, 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 robadaCuenta de servicio de Google Play con Manage orders and subscriptionsIn-App Purchase key de Apple
Reembolsar un pedidoSí, pedidos de hasta 3 añosNo, solo Apple reembolsa
Cortar el acceso de un compradorSí, con revoke al reembolsarNo
Cancelar o ampliar suscripcionesCancelar, síAmpliar fechas de renovación hasta 90 días, de forma irreversible
Leer datos de comprasSí, con el permiso de visualizaciónSí, historial de transacciones y reembolsos
Responder a revisiones de reembolsoSí, orders.reviewrefundSí, Send Consumption Information
Limitarla a una appSí, mediante permisos de appNo, 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é.

Una desarrolladora en su escritorio revocando un acceso en un portátil, con una fila de llaves colgadas en la pared y un gancho vacío, que ilustra cómo retirar permisos de la cuenta de servicio de Google Play

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.

TareaCuenta de servicio de Google PlayIn-App Purchase key de Apple
Quién puede crearlaSe crea en Google Cloud y luego se invita en Users and permissions de Play ConsoleAccount Holder o Admin
¿Se puede volver a descargar el secreto?Creas una clave nuevaNo, una sola descarga
Caducidad por defectoNingunaNinguna, hasta que la revoques
Cómo cortar el acceso rápidoEliminar la clave en IAM o quitar la cuenta en Play ConsoleRevocar la clave en App Store Connect
Efectos secundarios de cortar el accesoCualquier herramienta que use esa cuenta deja de llamar a la APILas 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

RefundHalt

El piloto automático de reembolsos para App Store y Google Play

Seguir leyendo

La próxima solicitud de reembolso ya está en camino.

Configura RefundHalt en el tiempo que tardas en leer otro correo de soporte sobre un reembolso que no llegaste a impugnar.