external-purchases

Implements US web checkout via the StoreKit External Purchase Link entitlement with commission-flip-ready architecture.

696|66|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/rshankras/claude-code-apple-skills --skill external-purchases
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: external-purchases
Source: https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/monetization/external-purchases
Command: npx skills add https://github.com/rshankras/claude-code-apple-skills --skill external-purchases

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

US storefront apps can now link out to web checkout for digital goods at 0% Apple commission, but the entitlement rules are strict and the legal situation is reversible — this Skill helps you ship external purchase links compliantly while architecting so a future commission ruling is a config change, not a rewrite.

Core Features & Use Cases

  • Entitlement Compliance: Guides correct use of the com.apple.developer.storekit.external-purchase-link entitlement, Info.plist declaration, and US-only storefront gating to avoid Guideline 3.1.1 rejections.
  • Commission-Flip Architecture: Centralizes link-out through a single stamped service with a remote-configurable CommissionPolicy so a future Apple commission can be toggled on without code changes.
  • IAP vs Web Checkout Decisions: Provides decision criteria for subscriptions, consumables, existing IAP subscribers, and B2B scenarios, plus funnel analytics comparing web checkout conversion against IAP.
  • Use Case: You want to add a Stripe web checkout for US subscribers while keeping IAP for other storefronts — this Skill walks you through the entitlement, the centralized link-out service, and the analytics to measure whether 0% commission beats IAP's lower friction.

Quick Start

Ask Claude to add a compliant US external purchase link with web checkout to my app using the external-purchases skill.

Frequently Asked Questions about external-purchases

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

FAQPage Schema
How do I add an external purchase link to my iOS app?

Add the com.apple.developer.storekit.external-purchase-link entitlement with the matching Info.plist declaration, then present the link per the entitlement's UI terms using StoreKit's ExternalPurchaseLink. A bare link without the entitlement will be rejected under Guideline 3.1.1.

Should I use web checkout or IAP for my app's subscriptions?

For US-heavy subscription revenue with ARPU high enough to absorb processor fees and your own support, web checkout at 0% commission can win. For impulse-priced consumables, IAP usually converts better because checkout friction eats more than the 15–30% commission.

Does the StoreKit external purchase link work outside the US?

No, the entitlement covered here applies to the US storefront only. The EU, Japan, and Korea have separate entitlements and terms, and elsewhere Guideline 3.1.1 still requires IAP, so keep StoreKit as a fallback for non-US storefronts.

What happens if Apple's commission on external purchases comes back?

If you route all in-app-initiated checkouts through one stamped link-out service and keep a remote-configurable CommissionPolicy with rate, scope, and effective date, a future ruling becomes a config change. Scattered openURL calls make the flip un-auditable and expensive.

Why was my app rejected for an external purchase link?

Rejections typically come from missing the external-purchase-link entitlement, linking from a non-US storefront, or not following the entitlement's UI presentation terms. Verify the entitlement, Info.plist declaration, and storefront gating before resubmitting.