コンテンツにスキップ

マーケットごとの購入、キャンセル、返金履歴

購入履歴を取得

基本

指定された期間のアプリの購入履歴を取得します。

  説明
リクエストURL https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list
メソッド POST
HTTPヘッダー
  • Content-type: application/json
  • Authorization: Bearer (オプション)
    • Hive コンソールの認証フラグが AppCenter > Game Management > ゲームリスト: あなたの会社のゲームを選択 > ゲーム 詳細 > 基本情報 に設定されている場合のみ、Bearerトークンを使用できます。
    • Bearerトークンは、AppCenter > Game Management > ゲームリスト: あなたの会社のゲームを選択 > ゲーム 詳細 > 基本情報 にある認証キーです。
レスポンス形式 JSON

リクエスト

名前 タイプ 必須 説明
market 文字列 O マーケット名: google, apple, lebi, onestore, amazon, glaxystore, huawei, funtap, oppo, vivo, facebook, steam, hivestore (PG決済)
appid 文字列 O アプリのappid
startdate 文字列 O 検索する日付範囲の開始日 (例: 2023-07-10)
enddate 文字列 O 検索する日付範囲の終了日 (例: 2023-07-16、最大検索範囲は開始日と終了日を含めて7日間です)
transactionid 配列 X
  • ここで提供された購入トランザクションIDのみが購入履歴検索の対象となります (例: [ 'GPA.3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ])
  • プレイヤーIDが提供された場合、APIはプレイヤーIDによって行われたトランザクションIDの結果のみを返します (プレイヤーIDとトランザクションIDはAND条件です)。
  • 配列の最大長は50です。
playerid 配列 X
  • ここで提供されたプレイヤーIDによって行われた購入トランザクションのみが購入履歴検索の対象となります (例: [ '20000015911', '20000016015' ])
  • 購入トランザクションIDが提供された場合、APIはプレイヤーIDによって行われたトランザクションIDの結果のみを返します (トランザクションIDとプレイヤーIDはAND条件です)。
  • 配列の最大長は100です。
page_token 文字列 X
  • APIレスポンスページあたりの最大結果数は100です。
  • 前のページ/次のページをリクエストするには、このトークンを使用してAPIを再度呼び出します。

レスポンス

名前 タイプ 必須 説明
result_code 整数 O レスポンスコード (20000: 成功)
result_message 文字列 O レスポンスコードの結果メッセージ
data 配列 O レスポンスデータ
ㄴdate 文字列 O このAPIが呼び出された日付 (例: 20230714)
ㄴplayerid 文字列 O プレイヤーID (例: 20000015911)
ㄴpurchase_price 整数 O 購入した商品の価格 (例: 10000)
ㄴpurchase_currency 文字列 O 購入の通貨 (例: KRW, USD)
ㄴpurchase_date 文字列 O 購入日 (KST)
ㄴhiveiap_market_transaction_id 文字列 O 購入トランザクションID (例: GPA.3327-1260-4622-40400)
ㄴmarket 文字列 O 購入が行われたマーケット (例: APPLE, GOOGLE)
prev_page_token 文字列 X 前のページのトークン (前のページが存在しない場合は返されません)
next_page_token 文字列 X 次のページのトークン (次のページが存在しない場合は返されません)

Request examples

curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30"}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list

page_tokenの使用例

curl -L -v -d '{"page_token": "73U1mdaEvFRbJ5Zl/boHQY2Q3SQPJeWmKjO86UeLn4kDU72yzAfgmlciFvzTU6yaP0aZEGXTuRD2bLd9q48M+EVhm1glGZzHFj8MQvmQ1spuN9e0FzxczvWX27bDsObDGIJKb44Yg9GkMr6Aoq/Lrf855zKm20Z5+P9pJK8114iJZUHUhQT1E4LyrvdRvQCRlWl1Y8oHRAP4P4hsvwJO618K6/shJ86VqLbIs6bVW1w="}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list

transactionidの使用例

curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","transactionid" : ["GPA.3343-6111-5443-03063","GPA.3354-3096-3913-84573"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list

playeridの使用例

curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","playerid" : ["25647", "25645"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list

transactionid と playerid を使用する例 (AND 条件)

curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","transactionid" : ["GPA.3343-6111-5443-03063","GPA.3354-3096-3913-84573"],"playerid" : ["25647", "25645"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list

 

> POST /api/creator/market_purchase_list HTTP/2
> Host: hiveiap-void.qpyou.cn
> User-Agent: curl/7.84.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> Content-Length: 126

Response examples

< HTTP/2 200 OK
< Server: nginx
< Date: Fri, 14 Jul 2023 01:51:12 GMT
< Content-Type: application/json; charset=utf-8
< Transfer-Encoding: chunked
< Connection: close
<
* Closing connection 0
{"result_code":20000,"result_message":"Succeeded","data":[{"date":"20230530","playerid":"111111111","purchase_price":5500,"purchase_currency":"KRW","purchase_date":"2023-05-30 12:00:00","hiveiap_market_transaction_id":"gd123","market":"google"},{"date":"20230530","playerid":"111111111","purchase_price":5500,"purchase_currency":"KRW","purchase_date":"2023-05-30 12:00:00","hiveiap_market_transaction_id":"gd123","market":"google"},{"date":"20230530","playerid":"111111111","purchase_price":5500,"purchase_currency":"KRW","purchase_date":"2023-05-30 12:00:00","hiveiap_market_transaction_id":"gd123","market":"google"}]}

無効化された購入・返金履歴を取得する

指定された期間のアプリの無効化された購入または返金履歴を取得します。

Basics

  説明
URL https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list
メソッド POST
HTTP ヘッダー
  • Content-type: application/json
  • Authorization: Bearer (オプション)
    • 認証フラグがHive コンソール AppCenter > Game Management > ゲームリスト: あなたの会社のゲームを選択 > ゲーム 詳細 > 基本情報に設定されている場合のみ、Bearer トークンを使用できます。
    • Bearer トークンは、AppCenter > Game Management > ゲームリスト: あなたの会社のゲームを選択 > ゲーム 詳細 > 基本情報にある認証キーです。
レスポンス形式 JSON

Request

名前 タイプ 必須 説明
market 文字列 O マーケット名: google, apple, onestore, amazon, huawei, steam, hivestore(PG決済)
appid 文字列 O アプリのappid
startdate 文字列 O 検索する日付範囲の開始日 (例: 2023-07-10)
enddate 文字列 O 検索する日付範囲の終了日 (例: 2023-07-16、最大検索範囲は開始日と終了日を含む7日間)
transactionid 配列 X
  • キャンセルまたは返金された購入のtransactionidのみが、キャンセルされた購入または返金履歴の検索対象となります (例: [ 'GPA.3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ])
  • playeridが提供された場合、APIはplayeridによって行われたキャンセルまたは返金された購入のtransactionidの結果のみを返します (playeridとtransactionidはAND条件です)。
  • 配列の最大長は50です。
playerId 配列 X
  • playeridによって行われたキャンセルまたは返金された購入の取引のみが、キャンセルされた購入または返金履歴の検索対象となります (例: [ '20000015911', '20000016015' ])
  • 購入のtransactionidが提供された場合、APIはplayeridによって行われたキャンセルまたは返金された購入のtransactionidの結果のみを返します (transactionidとplayeridはAND条件です)。
  • 配列の最大長は100です。
    		•
    page_token 文字列 X
    • APIレスポンスページあたりの最大結果数は100です。
    • 前のページ/次のページをリクエストするには、このトークンを使用してAPIを再度呼び出します。

    レスポンス

    名前 タイプ 必須 説明
    result_code 整数 O レスポンスコード (20000: 成功)
    result_message 文字列 O レスポンスコードの結果メッセージ
    data 配列 O レスポンスデータ
    ㄴdate 文字列 O このAPIが呼び出された日付 (例: 20230714)
    ㄴplayerid 文字列 O プレイヤーID (例: 20000015911)
    ㄴvoided_purchase_date 文字列 O 無効化・返金の日付 (KST)
    ㄴpurchase_date 文字列 O 購入の日付 (KST)
    ㄴhiveiap_market_transaction_id 文字列 O 購入トランザクションID (例: GPA.3327-1260-4622-40400)
    ㄴmarket 文字列 O 購入が行われたマーケット (例: APPLE, GOOGLE)
    prev_page_token 文字列 X 前のページのトークン (前のページが存在しない場合は返されません)
    next_page_token 文字列 X 前のページの次 (次のページが存在しない場合は返されません)

    Request examples

    curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-06-21","enddate": "2023-06-27"}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list

    page_tokenの使用例

    curl -L -v -d '{"page_token": "73U1mdaEvFRbJ5Zl/boHQY2Q3SQPJeWmKjO86UeLn4kDU72yzAfgmlciFvzTU6yaP0aZEGXTuRD2bLd9q48M+EVhm1glGZzHFj8MQvmQ1spuN9e0FzxczvWX27bDsObDGIJKb44Yg9GkMr6Aoq/Lrf855zKm20Z5+P9pJK8114iJZUHUhQT1E4LyrvdRvQCRlWl1Y8oHRAP4P4hsvwJO618K6/shJ86VqLbIs6bVW1w="}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list

    transactionidの使用例

    curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","transactionid" : ["GPA.3343-6111-5443-03063","GPA.3354-3096-3913-84573"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list

    playeridの使用例

    curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","playerid" : ["25647", "25645"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list

    transactionid と playerid を使用する例 (AND 条件)

    curl -L -v -d '{"market": "google", "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common","startdate": "2023-05-30","enddate": "2023-05-30","transactionid" : ["GPA.3343-6111-5443-03063","GPA.3354-3096-3913-84573"],"playerid" : ["25647", "25645"]}' -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc" https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list

     

    > POST /api/creator/market_voided_purchase_list HTTP/2
> Host: hiveiap-void.qpyou.cn
> User-Agent: curl/7.84.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAzNzc4OTU2LCJqdGkiOiIxODczMTExMzIwIn0.OxWo4R6UdI0BLP1ckt8RlMFrPAb5H7TNedmLFV1Cawc
> Content-Length: 126

    Response examples

    < HTTP/1.1 200 OK
< Server: nginx
< Date: Fri, 14 Jul 2023 01:46:52 GMT
< Content-Type: application/json; charset=utf-8
< Transfer-Encoding: chunked
< Connection: close
<
{"result_code":20000,"result_message":"Succeeded","data":[{"date":"20230622","playerid":"25645","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 10:24:43","hiveiap_market_transaction_id":"GPA.3343-6111-5443-03063","market":"google"},{"date":"20230622","playerid":"25647","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 10:19:56","hiveiap_market_transaction_id":"GPA.3354-3096-3913-84573","market":"google"},{"date":"20230622","playerid":"25647","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 10:20:13","hiveiap_market_transaction_id":"GPA.3352-3543-2561-74345","market":"google"},{"date":"20230622","playerid":"25646","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 10:27:07","hiveiap_market_transaction_id":"GPA.3373-8959-5490-84662","market":"google"},{"date":"20230622","playerid":"20000015910","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 11:10:34","hiveiap_market_transaction_id":"GPA.3344-8133-4125-27484","market":"google"},{"date":"20230622","playerid":"20000015911","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 11:16:19","hiveiap_market_transaction_id":"GPA.3380-9359-5107-68068","market":"google"},{"date":"20230622","playerid":"20000015911","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 11:16:28","hiveiap_market_transaction_id":"GPA.3327-1260-4622-40400","market":"google"},{"date":"20230622","playerid":"20000015903","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-06-22 11:21:26","hiveiap_market_transaction_id":"GPA.3345-5718-8100-76220","market":"google"},{"date":"20230622","playerid":"20000016015","voided_purchase_date":"2022-06-22 10:24:43","purchase_date":"2022-08-25 15:34:45","hiveiap_market_transaction_id":"GPA.3381-4857-7750-97692","market":"google"},{"date":"20230622","playerid":"20000015903","voided_purchase_date":"2022-09-26 12:36:14","purchase_date":"2022-09-06 20:18:42","hiveiap_market_transaction_id":"GPA.3354-3949-3274-33990","market":"google"},{"date":"20230622","playerid":"68261244","voided_purchase_date":"2022-10-24 15:08:16","purchase_date":"2022-10-24 13:04:28","hiveiap_market_transaction_id":"GPA.3362-7733-7126-48410","market":"google"},{"date":"20230622","playerid":"68261245","voided_purchase_date":"2022-10-24 15:08:16","purchase_date":"2022-10-24 13:08:43","hiveiap_market_transaction_id":"GPA.3389-6928-6486-44334","market":"google"},{"date":"20230622","playerid":"68261245","voided_purchase_date":"2022-10-24 15:08:16","purchase_date":"2022-10-24 13:08:53","hiveiap_market_transaction_id":"GPA.3340-6178-9215-37643","market":"google"},{"date":"20230622","playerid":"68261246","voided_purchase_date":"2022-10-24 15:08:16","purchase_date":"2022-10-24 13:13:14","hiveiap_market_transaction_id":"GPA.3310-2376-2428-34315","market":"google"},{"date":"20230622","playerid":"26908","voided_purchase_date":"2022-11-03 12:26:24","purchase_date":"2022-11-03 11:03:49","hiveiap_market_transaction_id":"GPA.3332-1770-9932-22016","market":"google"},{"date":"20230622","playerid":"20000017958","voided_purchase_date":"2022-12-28 18:00:00","purchase_date":"2022-12-28 18:21:05","hiveiap_market_transaction_id":"GPA.3380-0746-5400-99267","market":"google"},{"date":"20230622","playerid":"20000015911","voided_purchase_date":"2023-02-02 15:47:55","purchase_date":"2023-02-02 14:56:06","hiveiap_market_transaction_id":"GPA.3302-6734-9811-59555","market":"google"},{"date":"20230622","playerid":"25647","voided_purchase_date":"2023-02-02 15:47:55","purchase_date":"2023-02-02 15:33:51","hiveiap_market_transaction_id":"GPA.3308-0447-3039-63671","market":"google"},{"date":"20230622","playerid":"25646","voided_purchase_date":"2023-02-02 15:47:55","purchase_date":"2023-02-02 15:14:24","hiveiap_market_transaction_id":"GPA.3322-4622-9631-28260","market":"google"},{"date":"20230622","playerid":"25647","voided_purchase_date":"2023-02-02 15:47:55","purchase_date":"2023-02-02 15:33:22","hiveiap_market_transaction_id":"GPA.3343-5435-0468-97182","market":"google"
}],"next_page_token":"73U1mdaEvFRbJ5Zl\/boHQY2Q3SQPJeWmKjO86UeLn4kDU72yzAfgmlciFvzTU6yaP0aZEGXTuRD2bLd9q48M+EVhm1glGZzHFj8MQvmQ1spuN9e0FzxczvWX27bDsObDGIJKb44Yg9GkMr6Aoq\/Lrf855zKm20Z5+P9pJK8114irnVlbr8XNb0AmpWbYBxfNwgztBwQcFkQ\/euLTqm24RsV11WJfvxGzT1dyOFILlsU="}

    Response codes

    レスポンスコード 説明
    20000 成功
    40000 リクエストエラー
    ㄴresult_message
    • 空のリクエスト
    • 無効なjson形式
    • 無効なリクエスト - appid
    • 無効なリクエスト - apiキー
    • 無効なリクエスト - enddate
    • 無効なリクエスト - startdate
    • 無効なリクエスト - page_token
    50000 サーバーエラー