使用RVS云沙盒
使用RVS云沙盒
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。
RVS云沙盒是一个适用于RVS（收据验证服务）的沙盒环境，可以用于验证App Tester生成的收据。
要求
在使用RVS云沙盒之前，请确保您的环境符合以下要求。
App Tester
RVS云沙盒用于验证由App Tester生成的收据，App Tester会为每个完成的应用内购买发送收据。您需要将App Tester发出的收据传递到您的应用服务器，然后调用RVS云沙盒以验证收据。
在使用RVS云沙盒之前，您需要在Vega模拟器或Fire TV Stick上安装Amazon App Tester工具。有关更多详细信息，请参阅配置App Tester。
安全协议
该服务器需要通过HTTPS等安全协议安全地与RVS云沙盒通信。您的服务器将向RVS云沙盒发送验证请求并处理响应。
RVS响应对象
RVS云沙盒请求使用来自PurchaseResponse对象或PurchaseUpdatesResponse对象的数据。可以从这些响应对象中提取一个UserId，它表示用户的唯一标识符。PurchaseResponse对象包含ReceiptId，它与UserId一起用于对购买执行带外服务器端验证。有关该API的更多信息，请参阅IAP API概述。
发送RVS云沙盒请求
要使用RVS云沙盒，您必须通过HTTPS将请求发送到RVS云沙盒终端节点：https://appstore-sdk.amazon.com/sandbox。
请在请求中使用以下格式，用下表中的值替换尖括号中的术语：
https://appstore-sdk.amazon.com/sandbox/version/<Operation_version_number>/verifyReceiptId/developer/<Shared_Secret>/user/<UserId>/receiptId/<ReceiptId>
| 参数 | 描述 |
Operation_version_number
|
verifyReceiptId操作的版本号。此版本号独立于IAP版本号。当前verifyReceiptId版本号为“1.0”。
|
Shared_secret
|
用于标识发出请求的开发者的共享密钥。您可以在亚马逊应用商店的开发者账户的共享密钥页面上找到您的共享密钥。对于RVS云沙盒，共享密钥可以是任何非空字符串。RVS云沙盒服务器不会验证共享密钥，因为只有生产服务器才会验证它。 |
UserId
|
代表亚马逊应用商店应用中不同亚马逊客户的标识。在PurchaseResponse.getUserData().getUserId()中查找UserId。
|
ReceiptId
|
购买的唯一标识。在PurchaseResponse.getReceipt().getReceiptId()或PurchaseUpdatesResponse.getReceipts() → Receipt.getReceiptId()中查找ReceiptId。
|
RVS云沙盒示例
以下请求会在RVS云沙盒中验证收据：
https://appstore-sdk.amazon.com/sandbox/version/1.0/verifyReceiptId/developer/developerSecret/user/l3HL7XppEMhrOGDnur9-ulvqomrSg6qyODKmah76lJU=/receiptId/q1YqVbJSyjH28DGPKChw9c0o8nd3ySststQtzSkrzM8tCk43K6z0d_HOTcwwN8vxCrVV0lEqBmpJzs_VS8xNrMrP0ysuTSo2BAqXKFkZ6SilACUNzQxMzAyNjYyNDQ3MgDKJSlZpiTnFqTpK6UpWJUWlQEYahFELAA
此调用会收到一个来自RVS云沙盒服务器的JSON响应：
{
"autoRenewing": false,
"betaProduct": false,
"cancelDate": null,
"cancelReason": null,
"deferredDate": null,
"deferredSku": null,
"freeTrialEndDate": 1606985788979,
"gracePeriodEndDate": 1606985788979,
"parentProductId": null,
"productId": "com.amazon.subs1",
"productType": "SUBSCRIPTION",
"promotions": null,
"purchaseDate": 1604613233106,
"quantity": 1,
"receiptId": "q1YqVbJSyjH28DGPKChw9c0o8nd3ySststQtzSkrzM8tCk43K6z0d_HOTcwwN8vxCrVV0lEqBmpJzs_VS8xNrMrP0ysuTSo2BAqXKFkZ6SilACUNzQxMzAyNjYyNDQ3MgDKJSlZpiTnFqTpK6UpWJUWlQEYahFELAA",
"renewalDate": 1606985788979,
"term": "1 Month",
"termSku": "com.amazon.subs1_term",
"testTransaction": true
}
有关响应中字段的说明，请参阅RVS响应字段。
Last updated: 2025年9月30日
