# Paywall Parity Guidelines

Regional pricing for Google Play subscriptions: how targets are calculated,
what evidence sits behind them, and which capabilities are not built yet.

Status is one of: shipped, beta (built, gated behind a release check),
planned (specified, not implemented). A planned page describes something
that does not exist yet.

## Start here

- [What Paywall Parity does](/guidelines/overview) — The closed pricing loop, what each stage is responsible for, and which stages are live today.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/overview
- [Your first pricing matrix](/guidelines/quickstart) — Connect Google Play, import a catalogue, and read a full regional matrix. Roughly fifteen minutes, no store writes.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/quickstart
- [The safety model](/guidelines/safety-model) — Every rule that stands between a calculation and a real price change, and why each one exists.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/safety-model

## Concepts

- [Store baselines](/guidelines/store-baseline) — What Google's own converted price is, why it is shown beside your price, and every reason the column can be blank.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/store-baseline
- [Parity targets](/guidelines/parity-target) — How a recommended regional price is derived, from purchasing-power data through dampening, bounds, and rounding.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/parity-target
- [Strategies](/guidelines/strategies) — The three strategy presets, the exact intensities and bounds behind each, and how to choose between them.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/strategies
- [Confidence](/guidelines/confidence) — How the confidence score is computed, the thresholds that gate a recommendation, and when the system abstains entirely.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/confidence
- [Drift](/guidelines/drift) — The four drift severity bands, what triggers each, and why an exchange-rate movement can never authorize a store write.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/drift
- [Protected markets](/guidelines/protected-markets) — Markets whose price is held regardless of what the strategy computes, and how to tell a real recommendation from a data artifact.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/protected-markets

## Workflows

- [Connecting Google Play](/guidelines/connect-google-play) — The eight steps from a service-account key to an imported catalogue, and what to check when one of them fails.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/connect-google-play
- [Reviewing recommendations](/guidelines/review-recommendations) — How the inbox is ordered, what makes an item approvable, and what approval does and does not do.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/review-recommendations
- [Staging and publishing](/guidelines/dry-run-and-publish) — How a deployment draft is built and validated, what publishing does, and the release gate that keeps it off by default.
  status: beta · reviewed: 2026-09-21 · markdown: /guidelines/raw/dry-run-and-publish

## Reference

- [Pricing formulas](/guidelines/pricing-formulas) — The exact arithmetic behind a parity target and a confidence score, with every constant and weight stated.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/pricing-formulas
- [Error codes](/guidelines/error-codes) — Every error code the application surfaces, what actually caused it, and what to do about it.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/error-codes

## Integrations

- [Google Play](/guidelines/google-play) — The Android Publisher endpoints used, the scope and permissions required, and the limits of what the provider can do.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/google-play
- [Apple App Store](/guidelines/apple-app-store) — Apple support is planned and not implemented. What exists, what has to change, and what would have to be proven.
  status: planned · reviewed: 2026-09-21 · markdown: /guidelines/raw/apple-app-store
- [Revenue signals](/guidelines/revenue-signals) — Outcome measurement is planned and not built. What it will require, and why no uplift claim is made today.
  status: planned · reviewed: 2026-09-21 · markdown: /guidelines/raw/revenue-signals

## Trust and operations

- [Credential custody](/guidelines/credential-custody) — Where store credentials live, what the application database holds, and why authenticated calls execute outside it.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/credential-custody
- [Methodology and sources](/guidelines/methodology) — Where the economic data comes from, how coverage and freshness are handled, and which markets cannot be analyzed.
  status: shipped · reviewed: 2026-09-21 · markdown: /guidelines/raw/methodology