Hive SDK v1.19.1부터 IAP v1과 IAP v2의 지원을 종료합니다. Hive SDK v1.19.1 이상의 환경에서는 Hive IAP v4를 적용하시기 바랍니다.

구글 취소·환불 목록 API는 구글 취소·환불 목록 수집 시스템에 수집된 취소된 구매 내역을 조회하고, 환불 처리 결과를 구글 취소·환불 목록 수집 시스템에 알리는 기능을 제공한다. (현재는 Google 마켓만 가능하다.)

구글 취소·환불 목록 시스템은 구글 마켓의 Voided Purchases API를 이용하여 게임 별로 취소된 구매 내역에 대한 데이터를 수집한다. 구글 취소·환불 목록 수집 시스템은 매 짝수 시 5분 (예. 12시 5분, 14시 5분) Hive AppID 시스템에 등록된 앱을 구글 취소·환불 목록 수집 시스템에 등록하고, 등록 시점으로부터 한 달 이내의 구매 취소 내역들을 수집하여 저장한다. 이후에는 30분마다 앱이 등록된 순서대로 앱에 대한 지난 24시간 동안의 취소 내역 데이터를 수집한다.

결제 취소 및 환불 시 아이템 회수 방식

  • 위 과정은 회수 가능한 아이템일 경우 가능한 플로우이다.
  • 패키지 상품에서 회수 가능·불가능 상품이 함께 있는 경우 기존과 동일하게 CS에서 환불처리 해야 한다.

 

취소된 구매 내역 조회 API

Hive IAP 구글 취소·환불 목록 수집 시스템에 수집된 취소된 구매 내역 데이터를 조회할 수 있는 기능이다.

  • Request URL
    상용 URL http://hiveiap-void.qpyou.cn/api/voided_purchases/google
    Sandbox URL http://sandbox-hiveiap-void.qpyou.cn/api/voided_purchases/google
    HTTP Method Post
    Content-Type text/html
    Data Format JSON
  • Request
    필드명 설명 타입 필수여부
    package_name 조회할 게임의 패키지명(앱아이디와 동일) String Y
    start_time_utc 조회 조건으로 해당 시간부터 수집된 취소 데이터를 조회 String N
    end_time_utc 조회 조건으로 해당 시간까지 수집된 취소 데이터를 조회 String N
    max_results 조회 요청 시 전달받을 최대 취소 내역 건수
    최대값 : 100, 기본값:100    		 Integer N
    next_page_token 조회 요청에 대한 결과가 max_results의 값보다 많아 전달받지 못한 조회 결과를 받기 위해 사용하는 필드 String N

바로 전 요청에 대한 응답에 next_page_token 값이 있었다면 해당 값을 next_page_token 필드에 반드시 넣어서 호출해야 다음 데이터를 전달받을 수 있다.

  • Response
    필드명 설명 타입
    result_code 요청 결과
    20000:조회 성공, 40000:요청 오류    		 Integer
    result_message 결과 메세지 String
    next_page_token 조회하여 전달해야 하는 취소 데이터 개수가 요청 시 명시된 max_results값 이상일 때 전달하지 못한 데이터를 요청자가 다시 요청할 수 있도록 알려주는 토큰 값 String
    voided_purchases 실제 취소된 구매 내역 데이터 목록으로 수집 시스템에 수집된 시간이 빠른 순서로 전달 자세히 Object Array
  • voided_purchases Object
    필드명 설명 타입
    purchase_token 인앱 구매 항목의 식별자 String
    status 인앱 구매 항목의 회수 여부 :
    • 0: 미처리 (데이터 수집만 된 상태)
    • 1: 성공
    • 2: 부분적 회수일 경우, 부분적 회수에 대한 성공(부분적 회수를 지원하는 게임에서만 이용)
    • 3: 실패    		 Integer
    registered_time_utc 취소된 구매 내역 데이터가 Hive IAP v2 구글 취소·환불 목록 수집 시스템에 수집된 시간.
    형식: UTC    		 String
    purchase_time_millis 취소된 구매 내역의 아이템을 유저가 구입했던 시간.
    형식: 유닉스 시간 값의 밀리세컨드    		 String
    voided_time_millis 구매를 취소한 시간.
    형식: 유닉스 시간 값의 밀리세컨드    		 String
  • Request Sample
  • Response Sample

 

환불 처리 결과 등록 API

환불 처리 결과 등록 API는 취소된 구매 내역 조회 API를 통해 받은 환불 정보를 기반으로 게임 서버가 해당 상품을 회수한 후, Hive IAP v2 구글 취소·환불 목록 수집 시스템에 회수 처리 결과를 전달해주는 API이다.

  • Request URL
    상용 URL http://hiveiap-void.qpyou.cn/api/withdrawal_result/google
    Sandbox URL http://sandbox-hiveiap-void.qpyou.cn/api/withdrawal_result/google
    HTTP Method Post
    Content-Type text/html
    Data Format JSON
  • Request
    필드명 설명 타입 필수여부
    package_name 회수 처리된 게임의 패키지명(앱아이디와 동일) String Y
    purchase_token 인앱 구매 항목의 식별자 String Y
    status 자동 회수 처리 성공 여부:
    • 1: 성공
    • 2: 부분적 회수일 경우, 부분적 회수에 대한 성공(부분적 회수를 지원하는 게임에서만 이용)
    • 3: 실패
    • 4: 구입(지급) 기록이 존재하지 않음    		 Integer Y
    order_id 구글 영수증 내 구글 마켓의 구매 식별자(order ID) String Y
    product_id 구글 영수증 내 구글 마켓의 구매 아이템 식별자 String Y
    server_id 게임 서버가 한 개 이상일 경우 존재하는 서버 구분값. Hive 아이템에서 사용하는 서버 구분 값과 동일 String Y
    client_ip 결제가 이루어진 유저의 IP 주소 String Y
    uid 환불 처리가 된 유저의 uid String Y
    vid 환불 처리가 된 유저의 PlayerID (V1인증의 경우 VID) String Y
    did 결제가 이루어진 유저의 기기 식별자 String Y
    currency 구매했던 상품의 화폐 코드 String N
    price 구매 건에 결제한 금액 String N
    product_name 구매했던 상품의 명칭 String N
    product_detail 구매했던 상품의 상세 정보로, 게임에서 자유롭게 이용 가능한 데이터 Array N
    product_sent_time_utc 구매했던 상품 지급 시각
    형식:UTC    		 String N
  • Response
    필드명 설명 타입
    result_code 응답 코드:
    • 20000: 등록 성공 (이미 항목이 존재하는 경우 업데이트, 기준은 purchase_token)
    • 40000: 요청 오류
    • 50000: 서버 오류    		 Integer
    result_message 결과 메세지 String
  • Request Sample
  • Response Sample