Guide
Apple Retention Messaging API guide
What the API does, what Apple requires, and where realtime routing fits.
Realtime URL
How to configure Apple's realtime retention URL
Sandbox first, production after the performance test, with separate URLs per environment.
Sandbox
How to run the sandbox performance test
What Apple checks before production, and how to avoid timeout failures.
Signing
How promotionalOfferSignatureV2 works
The JWS signature path for returning App Store promotional offers in realtime.
Messages
How to upload Retention Messaging messages
Message states, image rules, default messages, and IDs used in runtime responses.
Review states
Why messages stay PENDING
How Apple's message review states affect default and realtime retention flows.
Comparison
Apple Retention Messaging vs RevenueCat
How a retention control plane differs from a full subscription SDK and entitlement layer.
No SDK
Apple Retention Messaging without SDK integration
Why the retention callback is server-to-server and does not require app release work.