subscription-state-diagram

Look up Google Play subscription states, RTDN transitions, and access rules.

45|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/RevenueCat/play-billing-skills --skill subscription-state-diagram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subscription-state-diagram
Source: https://github.com/RevenueCat/play-billing-skills/tree/main/google-play/subscription-state-diagram
Command: npx skills add https://github.com/RevenueCat/play-billing-skills --skill subscription-state-diagram

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a quick and convenient reference to the full Google Play subscription state machine, allowing you to quickly understand subscription states, RTDN transitions, and access behavior.

Core Features & Use Cases

  • Subscription State Lookup: quickly find any subscription state, RTDN, access rule, and expected token behavior.
  • RTDN Transition Table: easily understand which RTDN fires on a specific transition and what actions are required.
  • Token Lifecycle: learn how purchase tokens behave across different events like renewals, pauses, holds, and resubscribes.
  • Time Windows: reference time windows like grace period, account hold, and token validity.

Quick Start

Use the subscription-state-diagram skill to determine the next state for a subscription in 'ON_HOLD' from a RTDN of type 5.

Frequently Asked Questions about subscription-state-diagram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the Google Play subscription state machine handle RTDN transitions?

The Google Play subscription state machine uses Real-Time Developer Notifications (RTDN) to trigger transitions between states. You can reference the RTDN transition table to understand which notification fires on a specific state change and what actions are required.

What is the next state for a Google Play subscription in ON_HOLD after an RTDN type 5?

Using the subscription state machine reference, you can determine the next state for a subscription in ON_HOLD after receiving an RTDN of type 5. The reference maps specific RTDN types to their resulting subscription states.

How do purchase tokens behave across Google Play subscription events like renewals and pauses?

Purchase tokens follow a specific lifecycle across Google Play subscription events. The state machine reference outlines expected token behavior during renewals, pauses, holds, and resubscribes to help you manage access.

Do I need to know RTDN types to use the Google Play subscription state reference?

Yes, you need prior knowledge of subscription states and RTDN types to use this reference effectively. The Skill supports state determination by looking up transitions based on specific RTDN types.

What are the time windows for grace period and account hold in Google Play billing?

The Google Play billing state machine defines specific time windows for grace period, account hold, and token validity. The reference provides lookup for these windows to help manage subscription access rules.