마켓별 구매, 취소, 환불 내역 조회
구매 내역 조회
특정 기간 동안 어떤 앱의 구매 내역을 조회합니다.
Basics
| 설명 |
| Request URL | https://hiveiap-void.qpyou.cn/api/creator/market_purchase_list |
| Method | POST |
| HTTP Header | - Content-type: application/json
- Authorization: Bearer (선택사항)
- Hive 콘솔 앱센터 > 게임관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보 에서 Hive 인증 상태가 Y일때만 Bearer 토큰을 사용할 수 있습니다.
- Bearer 토큰은 앱센터 > 게임관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보 에서 Hive 인증키에 해당합니다.
|
| Response Format | JSON |
Request
| 명칭 | 타입 | 필수 여부 | 설명 |
| market | String | O | 마켓 명칭: google, apple, lebi, onestore, amazon, glaxystore, huawei, funtap, oppo, vivo, facebook, steam, hivestore(PG 결제) |
| appid | String | O | 앱의 appid |
| startdate | String | O | 조회할 시작 일자 (예: 2023-07-10) |
| enddate | String | O | 조회할 종료 일자 (예: 2023-07-16 시작일과 종료일을 포함해 총 기간은 최대 7일) |
| transactionid | Array | X | - 특정 구매 transactionid들에 해당하는 구매 결과만을 조회 (예: [ 'GPA. 3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ])
- playerid와 함께 사용 시, playerid들과 transactionid들은 AND 조건으로 적용됨
- 최대 50개까지 입력 가능
|
| playerid | Array | X | - 특정 playerid들이 일으킨 구매 결과만을 조회 (예: [ '20000015911', '20000016015' ])
- transactionid와 함께 사용 시, transactionid들과 playerid들은 AND 조건으로 적용됨
- 최대 100개까지 입력 가능
|
| page_token | String | X | API 응답 1페이지당 100개 결과가 출력됨
이전/다음 페이지 결과를 호출하려면, 이 토큰을 사용하여 API를 다시 호출 |
Response
| 명칭 | 타입 | 필수 여부 | 설명 |
| result_code | Integer | O | 응답 코드 (20000: 성공) |
| result_message | String | O | 응답 코드에 따른 결과 메시지 |
| data | Array | O | 응답 데이터 |
| ㄴdate | String | O | 검색 날짜 (예: 20230714) |
| ㄴplayerid | String | O | playerid (예: 20000015911) |
| ㄴpurchase_price | Integer | O | 구매 금액 (예: 10000) |
| ㄴpurchase_currency | String | O | 구매 통화 (예: KRW, USD) |
| ㄴpurchase_date | String | O | 구매 날짜 (KST) |
| ㄴhiveiap_market_transaction_id | String | O | 구매 번호 (예: GPA.3327-1260-4622-40400) |
| ㄴmarket | String | O | 구매 마켓 (예: APPLE, GOOGLE) |
| prev_page_token | String | X | 이전 페이지 토큰 (이전 페이지 없으면 제공하지 않음) |
| next_page_token | String | 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 |
| Method | POST |
| HTTP Header | - Content-type: application/json
- Authorization: Bearer (선택사항)
- Hive 콘솔 앱센터 > 게임관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보 에서 Hive 인증 상태가 Y일때만 Bearer 토큰을 사용할 수 있습니다.
- Bearer 토큰은 앱센터 > 게임관리 > 게임목록 - 게임사 게임 선택 > 게임상세 > 기본정보 에서 Hive 인증키에 해당합니다.
|
| Response Format | JSON |
Request
| 명칭 | 타입 | 필수 여부 | 설명 |
| market | String | O | 마켓 명칭: google, apple, onestore, amazon, huawei, steam, hivestore(PG 결제) |
| appid | String | O | 앱의 appid |
| startdate | String | O | 조회할 시작 일자 (예: 2023-07-10) |
| enddate | String | O | 조회할 종료 일자 (예: 2023-07-16 시작일과 종료일을 포함해 총 기간은 최대 7일) |
| transactionid | Array | X | - 특정 구매 transactionid들을 취소 또는 환불한 결과만을 조회 (예: [ 'GPA.3383-2895-4485-57050', 'GPA.3381-4857-7750-97692' ])
- playerid와 함께 사용 시, API는 playerid가 일으킨 구매 transactionid들 중에서 취소 또는 환불한 결과만을 반환(playerid들과 transactionid들은 AND 조건으로 적용됨)
- 최대 50개까지 입력 가능
|
| playerid | Array | X | - 특정 playerid들이 구매 취소 또는 환불한 결과만을 조회 (예: [ '20000015911', '20000016015' ])
- 구매 transactionid들과 함께 사용 시, API는 playerid가 일으킨 구매 transactionid들 중에서 취소 또는 환불한 결과만을 반환(transactionid들과 playerid들은 AND 조건으로 적용됨)
- 최대 100개까지 입력 가능
|
| page_token | String | X | - API 응답 1페이지당 100개 결과가 출력됨
- 이전/다음 페이지 결과를 호출하려면, 이 토큰을 사용하여 API를 다시 호출
|
Response
| 명칭 | 타입 | 필수 여부 | 설명 |
| result_code | Integer | O | 응답 코드 (20000: 성공) |
| result_message | String | O | 응답 코드에 따른 결과 메시지 |
| data | Array | O | 응답 데이터 |
| ㄴdate | String | O | 검색 날짜 (예: 20230714) |
| ㄴplayerid | String | O | playerid (예: 20000015911) |
| ㄴvoided_purchase_date | String | O | 취소·환불 날짜 (KST) |
| ㄴpurchase_date | String | O | 구매 날짜 (KST) |
| ㄴhiveiap_market_transaction_id | String | O | 구매 번호 (예: GPA.3327-1260-4622-40400) |
| ㄴmarket | String | O | 구매 마켓 (예: APPLE, GOOGLE) |
| prev_page_token | String | X | 이전 페이지 토큰 (이전 페이지 없으면 제공하지 않음) |
| next_page_token | String | 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 | - Empty Request
- Invalid json format
- Invalid request - appid
- Invalid request - api key
- Invalid request - enddate
- Invalid request - startdate
- Invalid request - page_token
|
| 50000 | 서버 오류 |