購入の詳細（ProductV2）

この API は、ProductV2 サービスから購入の詳細を提供します。purchaseToken を使用して、購入に関する詳細情報を取得できます。Order UID（他の API で使用できます）の取得や購入ステータスの検証に役立ちます。この API は認証を必要としません。

エンドポイント

メソッド	URL
GET	https://api.catappult.io/productv2/8.20250505/inapp/purchases/{purchase_token}

認証

認証は不要です。

パスパラメーター

パラメーター	型	必須	説明
purchase_token	string	必須	SDK の Purchase クラスで token として定義される購入 ID。

レスポンス

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

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

名前	型	説明
uid	String	Purchase クラスで token として定義される購入 ID。
sku	String	購入された製品の SKU。
domain	String	この購入の発生元となったアプリケーションのパッケージ名。
type	String	購入された製品のタイプ。
status	String	トランザクションのステータス。
state	String	トランザクションの状態。
payload	String	この購入を開始する際に開発者が指定した文字列ベースのペイロード。
created	String	作成日のタイムスタンプ。例：2025-01-14T11:06:31.231117Z
buyer	Object	購入者のソースの情報を含むオブジェクト。
buyer.type	String	購入者のタイプ。例：WALLET
buyer.reference	String	購入者の参照。
order	Object	支払いで行われた order の情報を含むオブジェクト。
order.uid	String	order の UID。Purchase クラスでは orderId として定義されています。
order.gateway	String	order のゲートウェイ。可能な値は broker です。
order.reference	String	order の参照 ID。Aptoide Connect のチャネルでは UID として定義されています。
order.status	String	行われた order のステータス。
order.created	String	作成日のタイムスタンプ。例：2025-01-14T11:06:31.231117Z

レスポンスの例

{
  "uid": "catappult.inapp.purchase.AXVCN5PZPXNYKQ7J",
  "sku": "attempts",
  "domain": "com.appcoins.diceroll.sdk",
  "type": "CONSUMABLE",
  "status": "COMPLETED",
  "state": "CONSUMED",
  "payload": "dee8217d-8f5b-427c-872c-fa5bb32c2444",
  "created": "2025-05-02T22:12:20.053838Z",
  "buyer": {
    "type": "WALLET",
    "reference": "0x6e581078d392f98a53a8e9b0a10a35169c431a1e"
  },
  "order": {
    "uid": "SEVD6MDBKR5XBZZU",
    "gateway": "broker",
    "reference": "SEVD6MDBKR5XBZZU",
    "status": "COMPLETED",
    "created": "2025-05-02T22:12:20.096345Z"
  }
}

type

値	説明
CONSUMABLE	製品タイプは Consumable（消費型）です。
SUBSCRIPTION	製品タイプは Subscription（サブスクリプション）です。

status

値	説明
PENDING	購入は、完了すべき 1 つ以上のアクションを保留中です。例：Consumption
COMPLETED	購入は正常に完了しています。
VOIDED	購入は無効化されています。

state

値	説明
PENDING	購入は確認または消費を保留中です。
CONSUMED	購入は消費されました。
ACKNOWLEDGED	購入は確認されました。

order.status

値	説明
PENDING	order は、完了すべき 1 つ以上のアクションを保留中です。
COMPLETED	order は正常に完了しています。
FAILED	order はエラーにより完了できませんでした。
CANCELED	order はキャンセルされ、完了できなくなった可能性があります。
REFUNDED	order は返金されました。
CHARGEDBACK	order はチャージバックされました。