メインコンテンツまでスキップ

アプリ内購入の検証

この API を使用すると、アプリ内購入の信頼性を検証できます。アイテムをユーザーに配信する前の最終検証に役立ち、購入が正しいことを確認し、不正を防止します。この API は認証を必要としません。

エンドポイント​

メソッドURL
GEThttps://api.catappult.io/productv2/8.20250505/google/inapp/v3/applications/{packageName}/purchases/products/{sku}/tokens/{purchaseToken}

認証​

認証は不要です。

パスパラメーター​

パラメーター型必須説明
packageNamestring必須アプリケーションのパッケージ名。
skustring必須購入に関連付けられた SKU。
purchaseTokenstring必須SDK の Purchase クラスでトークンとして定義された購入 ID。

レスポンス​

ステータス説明
200成功。購入の詳細を返します。

成功（200）のレスポンスフィールド​

名前型説明
kindStringproductPurchase を表します。
purchaseTimeMillisString製品が購入された時刻（ミリ秒単位）。
purchaseStateInteger注文の購入状態。
consumptionStateIntegerアプリ内製品の消費状態。
developerPayloadString注文に関する補足情報を含む、開発者が指定する文字列。
orderIdStringアプリ内製品の購入に関連付けられた注文 ID。
acknowledgementStateIntegerアプリ内製品の承認状態。
purchaseTokenString製品が購入されたときにユーザーのデバイスに提供されたトークン。
productIdString購入される製品の製品 ID。
regionCodeString購入が行われた場所のリージョンコード。
currencyStringISO 4217 のアルファベットコードで表される価格通貨。例: USD

レスポンス例​

{
    "kind": "androidpublisher#inappPurchase",
    "purchaseTimeMillis": "1741713309325",
    "purchaseState": 0,
    "consumptionState": 1,
    "developerPayload": "f54bedc1-65b3-4aa0-a3af-1c0eacc49bf7",
    "orderId": "Z3LGN5Q7HWR4EYNM",
    "acknowledgementState": 1,
    "purchaseToken": "catappult.inapp.purchase.B3TSKHOTY55JQFKS",
    "productId": "attempts",
    "regionCode": "PT",
    "currency": "EUR"
}

purchaseState​

値説明
0購入が正常に完了しました。
1購入がキャンセルされました。

consumptionState​

値説明
0購入は消費待ちです。
1購入が消費されました。

acknowledgementState​

値説明
0購入は承認待ちです。
1購入が承認されました。