Google Play Developer API release notes

This document contains release notes for the Google Play Developer APIs.

July 06, 2026

New features

• Updates to chargeback cost responsibility: Google Play now supports a collaborative chargeback dispute process.

  • Pending refund review notifications: A new real-time developer notification (RTDN) type, PendingRefundReviewNotification, is sent when a user requests a chargeback that requires your review. Pending reviews support only CHARGEBACK as the refund reason.

  • ReviewRefund API: You can evaluate these requests and respond within 24 hours by calling the new orders.reviewrefund API. In the API call, you must provide a refund preference (such as APPROVE, DECLINE, or NEUTRAL) and any relevant purchase usage evidence (such as user IP address, cumulative consumption percentage, and coarse geographic location) to help Google Play dispute the chargeback.

May 19, 2026

New features

• Pending order ID: The SubscriptionPurchaseV2 API now includes onHoldStateContext and inGracePeriodStateContext fields. These fields provide additional details, such as the pending or failed order ID, when a subscription enters the ON_HOLD or IN_GRACE_PERIOD state due to a declined renewal payment.

Deprecations

• Some of the subscription APIs are deprecated. For more information, see May 2026 Subscription API deprecation.

January 27, 2026

New features

• Subscription with add-ons deferral: Previously, the Google Play Developer API allowed deferral of billing only for single subscriptions. The deferral functionality is now available for both single subscriptions and subscriptions with add-ons through the purchases.subscriptionsv2.defer method. When you defer the billing date of a subscription with add-ons, the billing date for all items in the subscription are deferred by the specified duration.

• OfferPhase: The OfferPhase field is now available in the SubscriptionPurchaseV2 API. This field provides the current offer phase of the subscription as one of prorated period, free trial, introductory price and base plan price.

November 19, 2025

New features

• Enhanced Resubscribe handling.

  • The outOfAppPurchaseContext field is now available in SubscriptionPurchaseV2, which helps link resubscription purchases made from the Play Store by providing details from the expired subscription.
  • The purchases.subscriptions.acknowledge method now accepts optional externalAccountId in the request body, which lets you associate the resubscription purchase with your user identifiers.

• SubscriptionPurchaseLineItem.itemReplacement field is now available in SubscriptionPurchaseV2, which offers details about the item being replaced, if applicable.

• The Orders API now includes offerPhaseDetails field, which provides more detailed information on the orders funding a prorated period.

Sep 11, 2025

New features

• The SubscriptionPurchaseV2 API now provides the cancel method.

  This method provides an enhancement over the existing purchases.subscriptions.cancel functionality by introducing support for the cancellationType parameter in client libraries.

• Price step-up consent features are available:

  • A new field is added in the SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • A new real time developer notification type SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED is available.

June 30, 2025

New features

• The new ProductPurchaseV2 API that supports multiple purchase options and offers for one-time products is available.

May 21, 2025

Deprecations

• Some of the subscription APIs are deprecated. For more information, see Subscription API deprecation.

New features

• The following new fields are available in the SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• The subscriptionsv2.revoke method now provides the item_based_refund option.

• The Orders API now provides the get and batchGet methods.

Other changes

• The subscriptionId parameter is optional in the purchases.subscriptions APIs.