開発者コンソール
ログイン
ログイン
開発者コンソール

レシート検証サービス（RVS）の例

レシート検証サービス（RVS）の例

ここでは、RVS Sandbox環境とAmazon RVS本番サーバーでのRVSの例を、それぞれに対するレスポンスと共に紹介します。これらの例では実際に機能するURLを使用しているため、ブラウザにリクエストを貼り付けると、例と同じレスポンスを受け取ることができます。

例： RVS Cloud Sandboxの例

次のリクエストは、RVS Cloud Sandboxでレシートを検証します。

https://appstore-sdk.amazon.com/sandbox/version/1.0/verifyReceiptId/developer/developerSecret/user/l3HL7XppEMhrOGDnur9-ulvqomrSg6qyODKmah76lJU=/receiptId/q1YqVbJSyjH28DGPKChw9c0o8nd3ySststQtzSkrzM8tCk43K6z0d_HOTcwwN8vxCrVV0lEqBmpJzs_VS8xNrMrP0ysuTSo2BAqXKFkZ6SilACUNzQxMzAyNjYyNDQ3MgDKJSlZpiTnFqTpK6UpWJUWlQEYahFELAA

この呼び出しでは、RVS Cloud Sandboxサーバーから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本番サーバーを介した消費型アイテムの購入

次のリクエストは、本番サーバーで消費型アイテムの購入レシートを検証します。

https://appstore-sdk.amazon.com/version/1.0/verifyReceiptId/developer/2:smXBjZkWCxDMSBvQ8HBGsUS1PK3jvVc8tuTjLNfPHfYAga6WaDzXJPoWpfemXaHg:iEzHzPjJ-XwRdZ4b4e7Hxw==/user/LRyD0FfW_3zeOlfJyxpVll-Z1rKn6dSf9xD3mUMSFg0=/receiptId/wE1EG1gsEZI9q9UnI5YoZ2OxeoVKPdR5bvPMqyKQq5Y=:1:11

この呼び出しに対するJSONレスポンスの例は次のとおりです。

{
 "autoRenewing":false,
 "betaProduct":false,
 "cancelDate":null,
 "cancelReason":null,
 "freeTrialEndDate":null,
 "fulfillmentDate":null,
 "fulfillmentResult":null,
 "gracePeriodEndDate":null,
 "parentProductId":null,
 "productId":"com.amazon.iapsamplev2.gold_medal",
 "productType":"CONSUMABLE",
 "promotions":null,
 "purchaseDate":1399070221749,
 "purchaseMetadataMap":null,
 "quantity":1,
 "receiptId":"wE1EG1gsEZI9q9UnI5YoZ2OxeoVKPdR5bvPMqyKQq5Y=:1:11",
 "renewalDate":null,
 "term":null,
 "termSku":null,
 "testTransaction":true
}

purchaseDateとcancelDateは、ミリ秒単位の時間として表されます。これらの値を日付オブジェクトに変換するには、java.util.Date(timeInMillis)を呼び出します。cancelDateがnullの場合は、購入がキャンセルされていないことを示します。購入がキャンセルされた場合、対応するレシートのcancelDateは、Amazonカスタマーサポートが購入をキャンセルした日になります。

例：RVS本番サーバーを介した定期購入型アイテムの購入

次のリクエストは、本番サーバーで定期購入型アイテムの購入レシートを検証します。

https://appstore-sdk.amazon.com/version/1.0/verifyReceiptId/developer/2:SPOkNr03vVx0_u04edvPTf5t6VC-HHS4535VkVviYJp7fCvSepKM5Ys-_ODYdtw8:Y-tOqaWFAXCHluaxssj9VQ==/user/7m7UQpSnce0DcAOgcCZFVW5-sNc2rVYE6aQCGc6URNU=/receiptId/JyGJ5iEtYgFu1ngnQovTqSIHQxR53GsMLqkR1tKLp5c=:3:11

この呼び出しに対するJSONレスポンスの例は次のとおりです。

{
 "autoRenewing":false,
 "betaProduct":true,
 "cancelDate":1400784371000,
 "cancelReason":1,
 "freeTrialEndDate":null,
 "fulfillmentDate":null,
 "fulfillmentResult":null,
 "gracePeriodEndDate":null,
 "parentProductId":null,
 "productId":"sub1",
 "productType":"SUBSCRIPTION",
 "promotions":null,
 "purchaseDate":1400784241000,
 "purchaseMetadataMap":null,
 "quantity":null,
 "receiptId":"JyGJ5iEtYgFu1ngnQovTqSIHQxR53GsMLqkR1tKLp5c=:3:11",
 "renewalDate":null,
 "term":"1 Week",
 "termSku":"sub1-weekly",
 "testTransaction":true
}

purchaseDateとcancelDateは、ミリ秒単位の時間として表されます。これらの値を日付オブジェクトに変換するには、java.util.Date(timeInMillis)を呼び出します。cancelDateがnullの場合は、このレシートに対応する定期購入がまだ有効であることを示します。定期購入の期限が切れた場合、対応するレシートのcancelDateは、期限が切れた日またはAmazonカスタマーサポートが定期購入をキャンセルした日になります。cancelReasonは、定期購入がキャンセルされた理由を示します（指定できる値は、null、0、1、2です。各整数はキャンセル理由を表します）。gracePeriodEndDateがnullの場合は、このレシートに対応する定期購入が猶予期間中でないことを示します。定期購入が猶予期間中の場合、対応するレシートのgracePeriodEndDateは、定期購入の猶予期間が終了する日になります。

例：プロモーション価格での定期購入型アイテムの購入

定期購入型アイテムがプロモーション価格で購入された場合、verifyReceiptId APIからのレスポンスは次のようになります。

{
 "autoRenewing": true,
 "betaProduct": false,
 "cancelDate": null,
 "cancelReason": null,
 "deferredDate": null,
 "deferredSku": null,
 "freeTrialEndDate": 1651730558000,
 "fulfillmentDate": null,
 "fulfillmentResult": null,
 "gracePeriodEndDate": 1606985788979,
 "parentProductId": null,
 "productId": "1yearOTCharge",
 "productType": "SUBSCRIPTION",
 "promotions": [
    {
      "promotionStatus": "Queued",
      "promotionType": "Introductory Price - All customers"
    }
 ],
 "purchaseDate": 1651644158000,
 "receiptId": "IhE6m0uPLZ3dPz1WkGU5Ah6dmoDzJSLP3ed82jkxn2Y=:3:11",
 "renewalDate": 1651730558000,
 "term": "1 Week",
 "termSku": "1yearOnetimechargeterm",
 "testTransaction": false
}

例：RVS本番サーバーを介した非消費型アイテムの購入

次のリクエストは、本番サーバーで定期購入型アイテムの購入レシートを検証します。

https://appstore-sdk.amazon.com/version/1.0/verifyReceiptId/developer/2:smXBjZkWCxDMSBvQ8HBGsUS1PK3jvVc8tuTjLNfPHfYAga6WaDzXJPoWpfemXaHg:iEzHzPjJ-XwRdZ4b4e7Hxw==/user/LRyD0FfW_3zeOlfJyxpVll-Z1rKn6dSf9xD3mUMSFg0=/receiptId/mINy5VRd1FqjVOz-WBtTqw9FBGWhnuVx07kzTBMR600=:2:11

この呼び出しに対するJSONレスポンスの例は次のとおりです。

{
 "autoRenewing":false,
 "betaProduct":false,
 "cancelDate":null,
 "cancelReason":null,
 "freeTrialEndDate":null,
 "fulfillmentDate":null,
 "fulfillmentResult":null,
 "gracePeriodEndDate":null,
 "parentProductId":null,
 "productId":"com.amazon.iapsamplev2.gold_medal",
 "productType":"ENTITLED",
 "promotions":null,
 "purchaseDate":1399070221749,
 "purchaseMetadataMap":null,
 "quantity":1,
 "receiptId":"mINy5VRd1FqjVOz-WBtTqw9FBGWhnuVx07kzTBMR600=:2:11",
 "renewalDate":null,
 "term":null,
 "termSku":null,
 "testTransaction":true
}

purchaseDateとcancelDateは、ミリ秒単位の時間として表されます。これらの値を日付オブジェクトに変換するには、java.util.Date(timeInMillis)を呼び出します。cancelDateがnullの場合は、購入がキャンセルされていないことを示します。購入がキャンセルされた場合、対応するレシートのcancelDateは、Amazonカスタマーサポートが購入をキャンセルした日になります。

Last updated: 2023年10月25日