Configuración de Google Play

Refund Sensor se conecta a Google Play con una cuenta de servicio que creas en tu propio proyecto de Google Cloud. No caduca nunca y no hay que volver a autorizarla. Necesitarás:

• Un proyecto de Google Cloud en la cuenta propietaria de tu Play Console (uno gratuito sirve).
• Una cuenta de servicio con una clave JSON que puedas descargar.
• Acceso a Play Console y el rol Pub/Sub Admin concedido a esa cuenta.
• Los nombres de paquete o las URLs de Play Store que quieres defender.

1. Abre Google Cloud Console con la cuenta propietaria de tu Play Console y selecciona o crea un proyecto. En el menú de la izquierda abre IAM & Admin y pulsa Service accounts.
2. Pulsa + Create service account, ponle un nombre como RefundSensor Google Play API y pulsa Create and continue y Done. Aquí puedes saltarte los roles opcionales.
3. Copia el email de la cuenta de servicio (termina en .iam.gserviceaccount.com). Lo necesitarás en los pasos siguientes.
4. Abre la cuenta de servicio, ve a la pestaña Keys, pulsa Add key → Create new key, elige JSON y pulsa Create. Google descarga un archivo .json. Guárdalo bien; Google no te dejará descargarlo otra vez.

Tu proyecto necesita dos APIs de Google activadas (un paso único por proyecto). En Google Cloud Console, con tu proyecto seleccionado, busca y activa cada una:

• Google Play Android Developer API, que permite a la cuenta de servicio leer tus datos de reembolsos y pedidos.
• Cloud Pub/Sub API, que hace funcionar las notificaciones de reembolso en tiempo real. Asegúrate de que sea Cloud Pub/Sub y no Pub/Sub Lite, que es un producto distinto.

En Refund Sensor, abre Add app, elige Google Play y sube el archivo de clave .json. Lo verificamos con Google y lo guardamos cifrado en reposo con AES-256-GCM.

Invita a la cuenta de servicio a Play Console y dale acceso financiero en dos sitios, ya que los datos de reembolso (compras anuladas) se leen a nivel de cuenta:

1. En Google Play Console, abre Users and permissions → Invite new users y pega el email de la cuenta de servicio. Una cuenta de servicio queda activa en cuanto guardas; no acepta la invitación por sí misma.
2. En App permissions, añade cada app que quieras defender y activa View financial data y Manage orders and subscriptions.
3. Cambia a la pestaña Account permissions (fácil de pasar por alto) y, en Financial data, activa View financial data, orders and cancellation survey responses y Manage orders and subscriptions, y guarda.

Las notificaciones en tiempo real llegan a Refund Sensor por un tema de Pub/Sub que creamos y conectamos por ti, así que no hay nada que pegar en Play Console. Solo necesita permiso para gestionar Pub/Sub. En IAM & Admin → IAM, pulsa Grant access, pega el email de tu cuenta de servicio como principal, selecciona el rol Pub/Sub Admin (roles/pubsub.admin) y guarda. Elige Pub/Sub Admin, no Pub/Sub Lite Admin; el rol Lite no funciona y es la causa más habitual de que falle la configuración automática.

En el paso Add apps, pega una URL de Play Store o un nombre de paquete por línea (el nombre de paquete es el valor que va después de ?id= en un enlace de Play Store, por ejemplo com.yourcompany.app). Refund Sensor valida cada uno contra el acceso a Play Console de la cuenta conectada antes de importarlo y marca los que no puede ver.

Con las APIs activadas y Pub/Sub Admin concedido, importar una app crea automáticamente el tema y la suscripción push y la registra como endpoint de RTDN de la app. La app muestra entonces Awaiting first refund event hasta que Google entrega el primer evento real (no hay botón de prueba del lado de Google). Si la configuración automática llega a fallar, la tarjeta de la app muestra Real-time notifications not set up con un enlace de vuelta a esta guía.

No todos los reembolsos de Google Play se pueden discutir. Un reembolso normal de usuario lo decide Google por su cuenta, así que esos se registran para que los veas, pero no se cuestionan.

El único reembolso al que puedes responder de verdad es un contracargo en revisión (el pendingRefundReviewNotification de Google). Te da unas 24 horas y respeta la primera respuesta. Refund Sensor lo responde automáticamente con una recomendación de rechazo, bien dentro de la ventana.

Como red de seguridad, Refund Sensor también se reconcilia con la API de compras anuladas de Google, así cada reembolso y compra anulada queda registrado en tu panel incluso cuando no había nada que discutir.