每个市场的购买、取消、退款历史记录

获取购买历史¶

基础¶

获取给定时间段内应用的购买历史。

	描述
请求 URL	https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list
方法	POST
HTTP 头	Content-type: application/json Authorization: Bearer (可选) 只有在Hive 控制台的认证标志AppCenter > Game Management > 游戏列表: 选择您公司的游戏 > 游戏详情 > 基本信息设置为Y时，您才能使用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	仅提供的购买transactionids将作为购买历史搜索的目标（示例：[ 'GPA.3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ]）当提供playerids时，API将仅返回由playerids进行的transactionids的结果（playerids和transactionids为AND条件）。数组的最大长度为50。
playerid	数组	X	仅提供的playerids进行的购买交易将作为购买历史搜索的目标（示例：[ '20000015911', '20000016015' ]）当提供购买transactionids时，API将仅返回由playerids进行的transactionids的结果（transactionids和playerids为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"}]}

获取作废购买·退款历史¶

获取给定时间段内应用的作废购买或退款历史。

基础¶

	描述
网址	https://hiveiap-void.qpyou.cn/api/creator/market_voided_purchase_list
方法	POST
HTTP头	内容类型: application/json 授权: Bearer (可选) 只有在Hive控制台的认证标志AppCenter > Game Management > 游戏列表: 选择您公司的游戏 > 游戏详情 > 基本信息设置为Y时，您才能使用Bearer令牌。 Bearer令牌是AppCenter > Game Management > 游戏列表: 选择您公司的游戏 > 游戏详情 > 基本信息中的认证密钥。
响应格式	JSON

Request¶

名称	类型	必需	描述
market	字符串	是	市场名称: `google`, `apple`, `onestore`, `amazon`, `huawei`, `steam`, `hivestore`(PG支付)
appid	字符串	是	应用的appid
startdate	字符串	是	要搜索的日期范围的开始日期（示例：2023-07-10）
enddate	字符串	是	要搜索的日期范围的结束日期（示例：2023-07-16，最大搜索范围为7天，包括开始日期和结束日期）
transactionid	数组	否	仅被作废或退款的购买的transactionids将是作废购买或退款历史搜索的目标（示例：[ 'GPA.3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ]）当提供playerids时，API将仅返回由playerids进行的作废或退款购买transactionids的结果（playerids和transactionids为AND条件）。数组的最大长度为50。
playerId	数组	否	仅由playerids进行的作废或退款购买交易将是作废购买或退款历史搜索的目标（示例：[ '20000015911', '20000016015' ]）当提供购买transactionids时，API将仅返回由playerids进行的作废或退款购买transactionids的结果（transactionids和playerids为AND条件）。数组的最大长度为100。
page_token	字符串	否	每个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密钥无效的请求 - 结束日期无效的请求 - 开始日期无效的请求 - 页面令牌
50000	服务器错误