Receipt Verification Service Overview
The Receipt Verification Service (RVS) lets you validate purchases made by your app's users. RVS supports both sets of purchasing APIs offered by the Appstore—the Amazon In-App Purchasing (IAP) APIs in the Appstore SDK, and the APIs in the Appstore Billing Compatibility SDK.
Purchase workflow
The following image shows the purchase workflow with receipt verification. RVS starts after an Appstore purchasing API completes the purchase and returns the purchase receipt to the app.
The following table provides a text description of the image.
| Step | Component | Task |
|---|---|---|
| 1 | Appstore purchasing API (Amazon IAP API or Appstore Billing Compatibility API) |
Appstore purchasing API interacts with the user to complete the purchase. Appstore purchasing API returns a purchase receipt to the app. |
| 2 | App | App forwards the purchase receipt to the app server. |
| 3 | App server | App server sends a request to RVS server for validation of the receipt. |
| 4 | RVS server | RVS server confirms that the receipt is valid. |
| 5 | App server | App server makes the content available to the user. |
You can also use RVS to enable access to a subscription purchased on another platform, such as your website, as long as the purchase was made through Amazon. The following scenario describes this workflow:
- Your app's user purchases a subscription through Amazon via your company's website.
- Your app receives a receipt for the purchased subscription
- To enable access, your app then sends information from the receipt to your server. Finally, your server validates this transaction by querying RVS.
RVS supports both the IAP APIs in the Appstore SDK, and the APIs in the Appstore Billing Compatibility SDK.
RVS for Appstore SDK IAP
If your app uses IAP APIs from the Appstore SDK, you can use RVS for Appstore SDK IAP. RVS for Appstore SDK IAP contains a single RESTful API to validate the purchase receipts for all types of in-app items. For details on RVS for Appstore SDK IAP, see Receipt Verification Service for Appstore SDK IAP.
RVS for Appstore Billing Compatibility
If your app uses the Appstore Billing Compatibility SDK, you can use RVS for Appstore Billing Compatibility to verify the purchase receipts for consumables, entitlements, and subscriptions. RVS for Appstore Billing Compatibility provides two RESTful APIs, purchases.products.get and purchases.subscriptionsv2.get, which have similar interfaces as Google Play Developer APIs. These similarities simplify the integration process and reduce the required effort. For details on RVS for Appstore Billing Compatibility, see RVS for Consumables and Entitlements and RVS for Subscriptions.
Last updated: May 22, 2024