구매 내역 조회

특정 기간 동안 어떤 앱의 구매 내역을 조회합니다.

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

page_token 사용 예시

transactionid 사용 예시

playerid 사용 예시

transactionid와 playerid 사용 예시 (AND 조건)

 

Response Examples

취소·환불 내역 조회

특정 기간 동안 어떤 앱의 구매 취소 또는 환불 내역을 조회합니다.

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

    page_token 사용 예시

    transactionid 사용 예시

    playerid 사용 예시

    transactionid와 playerid 사용 예시 (AND 조건)

     

    Response Examples

    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 서버 오류