Credits and Subscriptions

Credits are the usage unit. Subscriptions are the recurring commercial relationship. Entitlements are the current permission state that the app checks at runtime.

Payment Records

Payment rows track checkout sessions, provider payment ids, subscription ids, provider subscription ids, invoice ids, invoice URLs, amounts, credits, and status changes.

Renewal Webhooks

A renewal webhook can create a fresh payment record from a provider subscription id even when the original payment id is not present. Once verified, the next cycle of credits is granted.

Entitlement State

Cancelations, failures, refunds, and subscription status changes should update entitlements so product access follows billing reality.