@mmerterden/multi-agent-pipeline 20.7.0 → 20.8.1

package/pipeline/skills/shared/external/storekit/references/app-review-guidelines.md

@@ -1,109 +1,98 @@
-# App Review Guidelines -- In-App Purchases and Subscriptions
-
-Use this as a StoreKit implementation guardrail for App Review payment issues.
-For full submission, privacy, metadata, entitlement, or rejection-risk audits,
-use the sibling `app-store-review` skill and re-check Apple's current App
-Review Guidelines.
-
-## Contents
-
-- [Guideline 3.1.1 Baseline](#guideline-311-baseline)
-- [What Generally Requires IAP](#what-generally-requires-iap)
-- [What Generally Does Not Require IAP](#what-generally-does-not-require-iap)
-- [External Purchase Links and Reader Apps](#external-purchase-links-and-reader-apps)
-- [Subscription Display Requirements](#subscription-display-requirements)
-- [StoreKit Implementation Checklist](#storekit-implementation-checklist)
-- [Common IAP Rejection Risks](#common-iap-rejection-risks)
-- [Pre-Submission Payments Checklist](#pre-submission-payments-checklist)
-- [References](#references)
-
-## Guideline 3.1.1 Baseline
-
-Digital content, app features, subscriptions, virtual goods, and services
-unlocked in the app generally must use Apple's In-App Purchase system unless a
-specific App Review guideline exception, storefront-specific rule, or approved
-entitlement applies.
-
-Do not present this as a universal ban on every external purchase link. The
-rules differ by storefront, entitlement, and app type, and they change over
-time. For a release audit, quote the current guidelines directly.
-
-## What Generally Requires IAP
-
-- Premium features or content unlocks
-- Subscriptions to app functionality
-- Virtual currency, coins, gems, or other digital goods
-- Ad removal
-- Digital tips or donations
-- Digital gift cards, certificates, vouchers, or coupons for digital goods
-
-## What Generally Does Not Require IAP
-
-- Physical products and e-commerce
-- Ride-sharing, food delivery, and real-world services
-- One-to-one services such as tutoring or consulting booked through the app
-- Enterprise or B2B apps distributed through Apple Business Manager
-
-## External Purchase Links and Reader Apps
-
-- Remove external purchase links, buttons, calls to action, and purchase paths
-  for digital goods unless the current storefront rules or an approved
-  entitlement explicitly allow them.
-- Reader apps may access content purchased elsewhere. Account-management or
-  sign-up links depend on current reader-app rules, storefront, and entitlement
-  status.
-- U.S. storefront behavior and some regional external-purchase entitlements are
-  different from the old blanket prohibition. Do not hardcode old guidance into
-  product or review advice.
-
-## Subscription Display Requirements
-
-- Clearly display price, duration, billing frequency, renewal behavior, and
-  cancellation terms before purchase.
-- Free trials must clearly state trial duration, post-trial price, billing
-  frequency, auto-renewal, and cancellation terms.
-- Subscriptions should provide ongoing value and be available across a user's
-  devices where the app supports them.
-
-## StoreKit Implementation Checklist
-
-- Categorize consumables, non-consumables, non-renewing subscriptions, and
-  auto-renewable subscriptions correctly in App Store Connect.
-- Provide working restore purchases for restorable products. StoreKit views can
-  expose this with `.storeButton(.visible, for: .restorePurchases)`.
-- Verify transactions with StoreKit 2 `VerificationResult`, current
-  entitlements, and server-side JWS validation when the business model requires
-  server authority.
-- Handle interrupted purchases, `.pending` Ask to Buy approvals, refunds,
-  revocations, Family Sharing changes, grace period, and billing retry.
-
-## Common IAP Rejection Risks
-
-1. **Unauthorized external purchase path.** The app links or directs users to
-   buy digital goods outside IAP without a current rule or entitlement allowing
-   that path.
-2. **Missing restore path.** Restorable products cannot be restored from the
-   paywall or store surface.
-3. **Unclear subscription terms.** Price, duration, renewal behavior, trial
-   conversion price, and cancellation terms are missing or hidden before
-   purchase.
-4. **Incorrect product categorization.** Consumables, non-consumables, and
-   auto-renewable subscriptions do not match the App Store Connect product
-   setup or the app's entitlement logic.
-
-## Pre-Submission Payments Checklist
-
-- [ ] Digital goods and app-unlocked features use IAP unless a current exception or approved entitlement applies
-- [ ] Subscription terms are visible before purchase
-- [ ] Free trial copy states post-trial price and billing frequency
-- [ ] External purchase links and CTAs are either removed or justified by a current storefront rule or approved entitlement
-- [ ] Restore purchases path is visible and functional for restorable products
-- [ ] Product types match App Store Connect configuration
-- [ ] Transaction verification uses StoreKit 2 APIs and server validation where needed
-- [ ] Ask to Buy, deferred approvals, refunds, and revocations are handled
-
-## References
-
-- [App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) -- use the original Apple URL because this guidelines page is not reliably available through Sosumi.
-- [StoreKit External Purchase Link Entitlement](https://sosumi.ai/documentation/bundleresources/entitlements/com_apple_developer_storekit_external-purchase-link)
-- [StoreKit External Purchase](https://sosumi.ai/documentation/storekit/external-purchase)
+# App Review Payment Guardrails
+
+This file keeps purchase code out of payment-related rejections. It is not a
+submission audit: privacy, metadata, entitlements in general and rejection
+risk across the whole app belong to `app-store-review`. Apple revises the
+guidelines often, so re-read the live text before relying on anything here.
+
+## The In-App Purchase Rule (3.1.1)
+
+If something digital is unlocked inside the app (content, a feature, a
+subscription, a virtual item, a digital service), the default is that it is
+sold through Apple's in-app purchase. The default gives way in three cases: a
+carve-out written into the guidelines, a rule that applies only in certain
+storefronts, and an entitlement Apple has granted to the app.
+
+That is why "every external purchase link is banned" is the wrong summary.
+The answer depends on the storefront, the entitlement, the kind of app and
+when you ask. When a release decision hangs on it, cite the guideline wording
+as it reads today.
+
+## Sold Through In-App Purchase, as a Rule
+
+- a premium tier or locked content;
+- a subscription to the app's own features;
+- coins, gems, credits and similar virtual items;
+- paying to hide ads;
+- tips or donations made digitally;
+- gift cards, vouchers or coupons that are spent on digital items.
+
+## Normally Outside In-App Purchase
+
+- goods that ship to a door, and e-commerce in general;
+- rides, meal delivery and services consumed in the physical world;
+- a person-to-person service, such as a lesson or a consultation, that the app
+  only books;
+- business apps handed out through Apple Business Manager.
+
+## Links Out, and Reader Apps
+
+- A button, banner or link that sends people to buy digital items elsewhere
+  has to go, unless the storefront's current rules or an entitlement the app
+  holds allows it.
+- A reader app may unlock content the user paid for outside the app. Whether
+  it may also link to sign-up or account management is decided by the current
+  reader-app provisions, the storefront and the entitlement.
+- In the United States, and in regions with an external-purchase entitlement,
+  the old outright prohibition no longer describes the rules. Keep guidance in
+  code comments and docs current rather than frozen.
+
+## What a Subscription Must Disclose
+
+- Before the user pays: the price, how long a period lasts, how often it
+  bills, the fact that it renews on its own, and how to cancel.
+- For a free trial, add how long the trial runs and what it costs once it
+  converts, again with the billing frequency, renewal and cancellation.
+- The subscription should keep earning its price over time and follow the
+  user to their other devices wherever the app is available there.
+
+## Purchase Code That Passes Review
+
+- Each product is created with the right type in App Store Connect:
+  consumable, non-consumable, non-renewing or auto-renewable.
+- Anything restorable can be restored; on store views,
+  `.storeButton(.visible, for: .restorePurchases)` provides the control.
+- Trust is established with StoreKit 2: `VerificationResult`,
+  `Transaction.currentEntitlements`, and a server that validates the signed
+  JWS when the business wants the server to be the authority.
+- The code copes with interrupted purchases, `.pending` Ask to Buy, refunds,
+  revocations, changes to Family Sharing, the grace period and billing retry.
+
+## Why Payment Builds Get Rejected
+
+1. A way to pay outside the app for digital items, with no rule or
+   entitlement that permits it.
+2. Restorable products, but the paywall or store screen offers no way to
+   restore them.
+3. Terms that the user cannot see before paying: price, period, renewal,
+   what a trial converts to, or how to cancel.
+4. A product configured as one type in App Store Connect, behaving as
+   another, with entitlement code that matches neither.
+
+## Final Payment Pass
+
+- [ ] Digital items and features are sold through in-app purchase, or a current exception or granted entitlement covers them
+- [ ] The full subscription terms appear before the purchase button
+- [ ] Trial wording names the post-trial price and billing interval
+- [ ] No outbound purchase link or call to action remains without a current storefront rule or entitlement behind it
+- [ ] Restore is on screen and actually restores
+- [ ] Product types agree with App Store Connect
+- [ ] StoreKit 2 verification is in place, with a server check where the business needs one
+- [ ] Ask to Buy, deferred approval, refunds and revocations all have a path
+
+## Apple Sources
+
+- [App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/)
+- [External purchase link entitlement](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_developer_storekit_external-purchase-link)
+  (`com.apple.developer.storekit.external-purchase-link`)
+- [External purchase in StoreKit](https://developer.apple.com/documentation/storekit/external-purchase)