Notas de la versión de la API de Google Play Developer

Este documento contiene las notas de la versión de las APIs de Google Play Developer.

6 de julio de 2026

Funciones nuevas

• Actualizaciones sobre la responsabilidad por los costos de devolución de cargos: Google Play ahora admite un proceso colaborativo de devolución de cargos de disputa.

  • Notificaciones de revisión de reembolsos pendientes: Se envía un nuevo tipo de notificación para desarrolladores en tiempo real (RTDN), PendingRefundReviewNotification, cuando un usuario solicita una devolución de cargo que requiere tu revisión. Las revisiones pendientes solo admiten CHARGEBACK como motivo de reembolso.

  • API de ReviewRefund: Puedes evaluar estas solicitudes y responder en un plazo de 24 horas llamando a la nueva orders.reviewrefund API. En la llamada a la API, debes proporcionar una preferencia de reembolso (como APPROVE, DECLINE o NEUTRAL) y cualquier evidencia de uso de compra pertinente (como la dirección IP del usuario, el porcentaje de consumo acumulado y la ubicación geográfica aproximada) para ayudar a Google Play a disputar la devolución de cargo.

19 de mayo de 2026

Funciones nuevas

• ID de pedido pendiente: La API de SubscriptionPurchaseV2 ahora incluye onHoldStateContext y inGracePeriodStateContext campos. Estos campos proporcionan detalles adicionales, como el ID de pedido pendiente o fallido, cuando una suscripción ingresa al estado ON_HOLD o IN_GRACE_PERIOD debido a un pago de renovación rechazado.

Bajas

• Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription de mayo de 2026.

27 de enero de 2026

Funciones nuevas

• Aplazamiento de suscripciones con complementos: Anteriormente, la API de Google Play Developer permitía el aplazamiento de la facturación solo para suscripciones individuales. La funcionalidad de aplazamiento ahora está disponible para suscripciones individuales y suscripciones con complementos a través del purchases.subscriptionsv2.defer método. Cuando aplazas la fecha de facturación de una suscripción con complementos, la fecha de facturación de todos los elementos de la suscripción se aplaza por la duración especificada.

• OfferPhase: El campo OfferPhase ahora está disponible en la API de SubscriptionPurchaseV2. Este campo proporciona la fase de oferta actual de la suscripción como uno de los siguientes períodos: período prorrateado, prueba gratuita, precio de lanzamiento y precio del plan base.

19 de noviembre de 2025

Funciones nuevas

• Se mejoró el manejo de la resuscripción.

  • El campo outOfAppPurchaseContext ahora está disponible en SubscriptionPurchaseV2, lo que ayuda a vincular las compras de resuscripción realizadas desde Play Store proporcionando detalles de la suscripción vencida.
  • El método purchases.subscriptions.acknowledge ahora acepta opcional externalAccountId en el cuerpo de la solicitud, lo que te permite asociar la compra de resuscripción con tus identificadores de usuario.

• El campo SubscriptionPurchaseLineItem.itemReplacement ahora está disponible en SubscriptionPurchaseV2, que ofrece detalles sobre el elemento que se reemplaza, si corresponde.

• La API de Orders ahora incluye el campo offerPhaseDetails, que proporciona información más detallada sobre los pedidos que financian un período prorrateado.

11 de septiembre de 2025

Funciones nuevas

• La API de SubscriptionPurchaseV2 ahora proporciona el método cancel.

  Este método proporciona una mejora sobre la funcionalidad existente purchases.subscriptions.cancel, ya que introduce compatibilidad con el parámetro cancellationType en las bibliotecas cliente.

• Las siguientes funciones de consentimiento para el aumento gradual del precio están disponibles:

  • Se agregó un campo nuevo en SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • Se encuentra disponible un nuevo tipo de notificación para desarrolladores en tiempo real: SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.

30 de junio de 2025

Funciones nuevas

• Ya está disponible la nueva API de ProductPurchaseV2, que admite varias opciones de compra y ofertas para productos únicos.

21 de mayo de 2025

Bajas

• Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription.

Funciones nuevas

• Los siguientes campos nuevos están disponibles en SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• El método subscriptionsv2.revoke ahora proporciona la opción item_based_refund.

• La API de Orders ahora proporciona los métodos get y batchGet.

Otros cambios

• El parámetro subscriptionId es opcional en las APIs de purchases.subscriptions.