無効化された購入一覧

この API は、特定のアプリケーションに関連付けられた無効化された購入を提供します。フィルターを使用して無効化された購入を取得できます。この API は認証を必要としません。

エンドポイント

メソッド	URL
GET	https://api.catappult.io/productv2/8.20250505/google/inapp/v3/applications/{packageName}/purchases/voidedpurchases

認証

認証は不要です。

パスパラメータ

パラメータ	型	必須	説明
packageName	string	必須	アプリケーションのパッケージ名。

クエリパラメータ

パラメータ	型	必須	説明
pageSelection.maxResults	integer	任意	各レスポンスに表示される無効化された購入の最大数。
pageSelection.token	string	任意	前回のレスポンスからの継続トークン。より多くの結果を表示できます。
type	integer	任意	受け取る無効化された購入のタイプ。0 — INAPP のみ（デフォルト）。1 — INAPP および SUBS。
startTime	string	任意	受け取りたい最も古い無効化された購入の時刻（ミリ秒単位）。
endTime	string	任意	受け取りたい最も新しい無効化された購入の時刻（ミリ秒単位）。

レスポンス

ステータス	説明
200	成功。無効化された購入の一覧を返します。

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

名前	型	説明
pageInfo	Object	ページネーション情報オブジェクト。
pageInfo.resultPerPage	Integer	現在のページの結果数。
tokenPagination	Object	トークンページネーションオブジェクト。
tokenPagination.nextPageToken	String	次の結果ページのトークン。
tokenPagination.previousPageToken	String	前の結果ページのトークン。
voidedPurchases	Array	無効化された購入オブジェクトの配列。
voidedPurchases[].kind	String	無効化された購入オブジェクトのタイプ。
voidedPurchases[].purchaseToken	String	購入の購入トークン。
voidedPurchases[].orderId	String	購入の注文 ID。
voidedPurchases[].purchaseTimeMillis	Long	購入が行われた時刻（ミリ秒単位）。
voidedPurchases[].voidedTimeMillis	Long	購入が無効化された時刻（ミリ秒単位）。
voidedPurchases[].voidedReason	Int	購入が無効化された理由。

レスポンス例

{
  "pageInfo": {
    "resultPerPage": 22
  },
  "tokenPagination": {
    "nextPageToken": null,
    "previousPageToken": null
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "catappult.inapp.purchase.QQATJ76ESKXMTLKY",
      "purchaseTimeMillis": 1721167420119,
      "voidedTimeMillis": 1721340431555,
      "orderId": "WJTG2ID4TQJSYOQK",
      "voidedReason": 0
    }
  ]
}

voidedReason

値	説明
0	購入が返金されました（REFUNDED）。
7	購入がチャージバックされました（CHARGEDBACK）。