RVS is the truth
What the device posts is never trusted for dates or state.
Store
Amazon Appstore receipt verification works through Amazon's Receipt Verification Service (RVS). Save your Amazon shared key in RevenueDot, and it sends every receipt to RVS, which is the only source of dates and state. Add RevenueDot's URL as a Real-time Notifications endpoint so renewals, grace periods and cancellations arrive through SNS.
Free until your app makes $10,000 a month. Switching from RevenueCat? Change one line.
What the device posts is never trusted for dates or state.
The signing certificate must come from an sns.<region>.amazonaws.com HTTPS URL.
RevenueDot confirms the SNS subscription by itself and the console shows Verified.
A missing or rejected key answers 5xx, so the SDK keeps the purchase and retries.
Setup
Add an Amazon app in RevenueDot with your package name. Its public SDK key starts with amzn_. Start for free on RevenueDot Cloud if you have no account.
In the Amazon Developer Console open Settings, Identity, and copy the Shared Key.
Paste the key on the app in RevenueDot and click Check credentials. RevenueDot asks RVS about a made-up receipt. Amazon answers 496 for a wrong key, so a bad key shows up here and not on a customer's purchase.
In the Amazon Appstore Console open your app, App Services, Real-time Notifications. Add an endpoint with your notification URL, which looks like https://api.revenuedot.app/v1/notifications/amazon/{app_id}, and click Submit. RevenueDot confirms the SNS subscription by itself.
Configure the Android SDK with your amzn_ key, as in the code below. The proxy URL line is needed only on your own server or with the stock RevenueCat SDK, because the RevenueDot SDK already points at RevenueDot Cloud.
Android code
// Only on your own server, or with the stock RevenueCat SDK:
// Purchases.proxyURL = URL("https://your-server")
Purchases.configure(AmazonConfiguration.Builder(this, "amzn_…").build()) GET /v1/receipts/amazon/{store_user_id}/{receipt_id} for a subscription's term SKU, then posts the receipt to POST /v1/receipts.store_identifier for subscriptions, such as pro.monthly.| What Amazon reports | Event |
|---|---|
| A new subscription receipt | INITIAL_PURCHASE (TRIAL during a free trial) |
renewalDate moved one term later | RENEWAL |
| Auto-renew turned off, or back on | CANCELLATION (UNSUBSCRIBE), UNCANCELLATION |
| A grace period | BILLING_ISSUE and CANCELLATION (BILLING_ERROR), access continues to the grace end date |
| Cancel date reached, or grace over | EXPIRATION |
| A deferred tier change | PRODUCT_CHANGE to the deferred SKU |
| A consumable or entitlement bought | NON_RENEWING_PURCHASE |
Webhooks report store: AMAZON. Amazon has no subscription pause.
Honest notes
FAQ
Send each receipt to Amazon's Receipt Verification Service (RVS) with your shared key. RevenueDot does this for you: save the shared key on the Amazon app, and every receipt the SDK posts is checked with RVS before access is granted.
In the Amazon Developer Console under Settings, Identity. Copy the Shared Key and paste it on the app in RevenueDot, then click Check credentials.
Yes. Configure the Android SDK with AmazonConfiguration and your amzn_ key. An app on the stock RevenueCat SDK also sets the proxy URL to RevenueDot before configure, sets entitlement verification to DISABLED and calls syncPurchases() once after the update.
Amazon publishes them through SNS to the endpoint you add in the Appstore Console. RevenueDot confirms the subscription, checks the SNS signature and re-reads the receipt from RVS before it changes anything.
Yes. Live App Testing and Amazon's test transactions are recorded as sandbox data, and App Tester receipts are checked against RVS's cloud sandbox. Amazon's accelerated test timelines are not supported.
Get started
Building and testing are free, and you can test your first purchase before you have a store account. Pro costs $0 until your apps make $10,000 a month.
Already have an account? Sign in · Switching from RevenueCat? Change one line