Subscription State Diagram

Subscription State Diagram

Phase 0: Intent

Use this skill when you need a single place to look up:

• What states a Google Play subscription can be in.
• Which RTDN (Real Time Developer Notification) moves a subscription from one state to the next.
• Whether a given state grants access to paid content.
• What token behavior to expect across renewals, pauses, holds, and resubscribes.

This is a reference skill. It does not write code for you. It hands you the map so you can point at a node, point at an edge, and then make a decision about access or acknowledgement.

Phase 1: Locate

Tell the skill which part of the state machine you care about. Pick the shortest path that matches your question.

A typical lookup looks like this:

1. Name the current state (for example IN_GRACE_PERIOD).
2. Name the event you observed (for example RTDN type 5).
3. Find the row in the From IN_GRACE_PERIOD table.
4. Read the target state and the access rule.

Phase 2: Reference Diagram

States at a Glance

Transition Table

Every edge in the diagram. Columns: origin state, destination state, trigger, RTDN name and numeric type.

RTDN Quick Reference by Number

Time Windows

Phase 3: Handling Guidance Per Transition

Each row tells you what to do when the RTDN lands. Pair this with the access rule in Phase 2.

Access Decision

Use the same rule across every handler.

fun shouldGrantAccess(
    state: String,
    expiryTimeMillis: Long
): Boolean = when (state) {
    "SUBSCRIPTION_STATE_ACTIVE",
    "SUBSCRIPTION_STATE_IN_GRACE_PERIOD" -> true
    "SUBSCRIPTION_STATE_CANCELED" ->
        System.currentTimeMillis() < expiryTimeMillis
    else -> false
}

Token Lifecycle

References

• Full chapter