Hive 크로스플레이는 PG결제를 기본으로 제공합니다.

Hive PG 결제 정책

구분 설명
언어
  • 16개국어 제공
  • PG사에서 제공하는 결제창은 PG사마다 지원하는 언어가 다르며, Hive가 관여하지 않음
동작
  • 외부 웹브라우저를 통한 결제로 서버 기반으로 동작 
국가 지원
  • PG사에서 지원하는 국가에 해당하는 PG사 노출
결제 수단
  • 계약한 PG사와 해당 PG사의 결제 수단은 Hive 콘솔에서 설정 필수
PG 결제 통화
  • Default : Hive_country로 판단한 국가의 통화
  • PG사에 따라 통화가 지원되지 않을 수 있음
  • Xsolla : 결제 수단에 따라 유저가 직접 결제할 통화를 선택할 수 있음
  • MyCard : 대만(TWD), 홍콩(HKD), 말레이시아(MYR), 싱가포르(SGD), 태국(THB), 인도네시아(IDR), 필리핀(PHP), 베트남(VND), 글로벌(USD)
Price Tier
  • Hive 콘솔에 업로드 필수
  • PG결제시 사용하는 티어로 모바일 마켓에는 적용되지 않음
  • PC용 앱아이디로 상품 등록시 금액이 아닌 Tier로 설정함
  • Tier는 게임별로 설정하며, PC용 앱아이디 생성시 기본 Tier를 제공함
상품관리
  • 상품가격, 상품명, 마켓PID등 Hive 콘솔에 등록 필수
환불유저재결제
  • 모바일 마켓과 동일하게 지원함

MyCard 직접 계약시 참고사항

  • 결제 수단별 통화에 따라 최저 및 최고 결제 금액이 지정되어있으므로 상품 가격  설정시 해당 사항에 주의가 필요함
    • 해당 금액 범위에 벗어난 상품의 경우 결제 요청시 에러메세지가 노출됨
  • MyCard 서비스 국가별 접속 화면
    대만(TWD), 홍콩(HKD), 말레이시아(MYR), 싱가포르(SGD), 태국(THB), 인도네시아(IDR), 필리핀(PHP), 베트남(VND) 글로벌(USD) : Worldwide로 변경후 결제

PG결제 과정

① 인 게임 상점에서 구매할 상품 선택

② 게임 화면 밖에서 웹뷰로 결제 수단 선택 창 노출

  • 언어 : 게임 언어
  • 통화 : SDK에서 전달주는 hive_country, 없으면 IP로 국가 확인하여 해당 국가의 통화로 노출. Price Tier에 없는 국가인 경우 USD로 노출됨
  • 결제 상품명은 콘솔 > 빌링 > IAP v4 > 마켓PID관리에 등록한 상품명을 노출. 노출할 언어의 상품명이 없을 경우 영어 상품명에 입력된 내용으로 표시됨
  • 결제수단은 콘솔 > 빌링 > PG 결제 설정 > PG사 설정에서 설정

③ 해당 국가에 맞는 PG사의 결제페이지를 호출하여 웹브라우저에서 노출

  • 결제 대상 국가가 아닐 경우 에러 페이지 노출

④ 결제 완료시 완료 페이지로 이동.  완료 페이지는 브라우저 언어로 노출됨

사전 작업

1. PG결제 플랫폼 설정

  • 포트원를 사용할 경우
    • 포트원 관리자 콘솔에 Hive IAP 서버 콜백 URL 등록 및 PG사 설정
      • 포트원 관리자 콘솔 > 시스템 설정 > 웹훅 설정 내 웹훅 발송 공통 URL 등록
      •  웹훅 URL
        • 상용 : https://store.withhive.com/payment/result_processing/import
        • 샌드박스 : https://sandbox-store.withhive.com/payment/result_processing/import
      • 주의 사항
        • 포트원에서는 샌드박스 결제 테스트를 제공하지 않으므로 테스트를 위해서 아래와 같은 방법을 제안합니다.
        • 포트원 계정을 상용서비스, 테스트용 2개를 생성합니다. 포트원 콘솔용 관리자 계정은 실제 계약과 상관없이 계정을 생성할 수 있습니다.
        • 포트원 상용 계정에는 상용 URL을 등록하고, Hive 상용 콘솔에 실제 서비스하는 PG사 정보등을 등록합니다. 
        • 포트원 테스트 계정에는 샌드박스 URL을 등록하고, Hive 샌드 박스 콘솔에는 테스트용 PG사 정보등을 등록합니다. 
        • 만일 실제 포트원 계정을 상용 서비스용으로 1개만 사용시에는 최초 적용시 샌드박스로 연결하여 테스트 후 정식 서비스때 상용 URL로 바꾸도록 합니다.
        • 상용 URL 로 변경한 후에는 절대 샌드박스 주소로 변경해서는 안됩니다. 실제 유저 결제도 테스트 결제로 처리되므로 반드시 주의해주세요.
        • 포트원 콘솔에서 PG사를 테스트로 설정한 경우, 결제한 내역은 익일 자동 취소됩니다. 상용 서비스 중인 게임은 절대 테스트로 설정해서는 안됩니다.
  • Xsolla를 사용할 경우
    • 플랫폼사업실에 하위 프로젝트 생성을 요청하여, Project ID와 Secret Key  를 발급

2. Hive 콘솔 설정

 

PG사 설정 가이드

게임에서 사용할 PG사를 설정합니다. 설정된 PG사는 삭제할 수 없으며 비활성화만 가능합니다.

① 게임 선택 : 게임을 조회하여 설정한 PG사를 확인할 수 있습니다. 게임 리스트가 보이지 않을 경우 게임 권한을 확인해주세요

② 게임 추가 : PG사 설정 페이지로 이동합니다.

③ 국가별 결제수단 보기 : 설정한 PG사의 국가별 결제 수단을 팝업에서 확인할 수 있습니다.

④ 수정 : 등록된 PG사 내용을 수정합니다.

 

게임별 PG사 등록하기 

게임 추가 버튼을 클릭하여 등록페이지로 이동합니다.

① 결제 결과를 받은 URL : 결제 완료 알림을 받을 서버 URL을 입력합니다. 구성 서버가 없을시 입력하지 않아도 되며 이 경우 게임서버에서 직접 아이템 미지급 결제건을 조회하여 영수증 검증 프로세스를 진행합니다.

② 결제 완료 알림 유형 : 결제 완료 알림 설정시 알림 유형을 선택합니다. 기본값은 결제 성공 정보만 전송입니다. 모두 전송 선택시 알림을 받는 서버에서 결제 성공과 취소에 대한 유형 분기 처리가 구성되어 있어야 합니다

③ 서비스 국가 : PG플랫폼별 사용 국가를 선택합니다. 선택한 옵션에 따라 하단 입력 항목이 변경됩니다. 마이카드의 경우 포트원이나 엑솔라를 통하지 않고 직접 계약하여 서비스하는 경우에 한하여 선택합니다.

④PortOne 정보 : PortOne 관리자 콘솔의 시스템 설정에 등록된 정보를 동일하게 입력합니다. 하위 상점이 있는 경우는 Tier Code를 반드시 입력해야 합니다. 네이버페이와 직접 계약 후 연동시에는 Chain Id 값을 반드시 입력해야 합니다.

⑤ Xsolla 정보 : Xsolla 콘솔  > 프로젝트 설정 > 일반 설정의 프로젝트 ID와 웹훅의 비밀 키를 복사하여 입력합니다.

⑥ Mycard 정보 : Mycard에서 제공한 FaServiceID를 입력합니다. 인증 번호(Hash) Key는 자동 생성됩니다. 생성된 HASH KEY를 Mycard 등록요청합니다.

⑦ PortOne- PG사 결제 수단 : PortOne 관리자 콘솔에서 설정한 PG사 목록을 자동으로 불러옵니다.  사용할 결제 수단을 선택할 때 KCP 의 경우 PG ID를 확인하여 PortOne 관리자 콘솔과 동일하게 활성화 해야합니다. PG ID별 활성화된 결제수단이 PortOne 관리자 콘솔과 다를 경우 정상 노출되지 않습니다. 가로스크롤을 오른쪽 끝으로 이동하면 설정한 결제수단을 미리볼 수 있는 버튼이 있습니다. PG사 계약을 위해 결제 테스트 페이지가 필요한 경우, 해당 미리보기 페이지의 URL을 복사하여 PG사에 제공하세요.

⑧ Xsolla- PG사 결제 수단 : 지원국가별 결제수단을 선택합니다. 미리보기 클릭시 구가구분없이 Xsolla의 활성화된 모든 결제 수단이 노출됩니다.

⑨ Mycard- PG사 결제 수단 : 결제 수단은 Mycard 하나 입니다.

PC결제 조회 및 취소

PortOne 또는 Xsolla의 결제내역을 한 페이지에서 모두 확인하고, 필요시 직접 취소 가능합니다. 페이먼트 월의 터미널3는 즉시 결제 취소가 아닌 결제 취소 요청을 보내며, 취소 완료 여부는 터미널3 콘솔에서 확인해야합니다.

  • PG사와 결제 수단
    •  PG사 설정에서 결제수단 활성화 여부와 상관없이 해당 업체에서 제공하는 모든 PG 목록을 선택옵션으로 제공합니다.
  • 상태
    • PG
      • 결제 완료 – 결제가 정상적으로 완료된 건
      • 결제 실패 – 결제 중 오류 등으로 인한 실패
      • 결제대기- 계좌이체등으로 인해 즉시 결제가 이뤄지지 않은 경우
      • 취소 요청 – 결제 취소 요청한 건
      • 취소 완료 – 정상적으로 결제 취소 된 경우. 터미널3 결제건은 취소 완료 여부 확인 불가
      • 취소 실패 – 취소 요청을 하였으나 실패한 건
      • 미진행 – 유저가 결제전에 결제창을 닫거나 결제 취소를 클릭하여 결제가 완료되지 않은 건
    • 스팀
      • 주문접수
      • 결제승인(사용자)
      • 결제 완료
      • 결제 취소
      • 결제 실패
      • 결제환불
      • 결제부분환불
      • 불법결제
      • 주문사기
      • 지불거절사기
      • 기타
      • 결제취소실패
  • 총 결제 금액 : 미진행을 제외한 검색 조건 전체 합계
  • 구매 완료 횟수 : 취소 건을 제외한 결제 완료된 건 수
  • 총 취소 금액/취소 횟수 : 취소 완료된 총 금액과 건 수
  • 상품 금액 : Price Tier에서 설정한 표시 통화의 상품 금액
  • Game_Payload_info : 아이템 지급 결과 전송 API를 통해 Hive 애널리틱스에서 추가 지표로 활용하기 위해 게임 서버로부터 전달 받는 값
  • IAP_Payload : 앱 개발자가 자체 정의한 구매 메타데이터
  • 주의 사항
    • PG사 설정에서 옵션값을 변경하면 변경전 설정값으로 결제한 내역은 콘솔에서 취소가 안될 수 있습니다.
      • 예1: PG사 설정에서 Xsolla를 사용하다 PortOne로 변경하면, 기존 Xsolla 결제 내역은 Hive 콘솔에서 취소 불가
      • 예2: PG사 설정에서 Tier 코드를 사용하다가 삭제한 경우, Tier 코드 사용 시점에 결제된 내역은 Hive 콘솔에서 취소 불가
    • PortOne 콘솔에서 결제 내역을 직접 취소할 경우 PG사에 따라 Hive 콘솔로 취소내역을 전송하지 않을 수 있으므로 가급적 Hive 콘솔을 통해서 취소를 진행

PC결제 아이템 재처리

PG결제가 정상적으로 완료되지 않은 내역을 조회할 수 있는 메뉴입니다. 재전송을 클릭하여 결제 프로세스를 정상적으로 완료하고 구매한 상품을 지급합니다. 재전송이 성공할 경우 조회 결과에서 사라집니다.

  • 메뉴 위치 : 콘솔 > 빌링 > IAP v4 > PG결제 지급완료 미처리 내역