콘텐츠로 이동

PG 결제

PC와 모바일에서 PG결제를 사용할 수 있습니다.

PG 결제 정책.

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

PG결제 과정

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

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

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

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

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

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

웹 상점에서 PG결제 구현하기

웹 사이트를 구축하여 상품을 판매할 때, 다음 과정에 따라 진행합니다.

① 콘솔 > 앱 센터에서 앱아이디 2개를 발급합니다.

  • 웹 로그인 용 앱아이디
    • 웹 로그인 AppID 선택
    • 사용 용도 Website로 선택
    • 만약, 기존에 Website로 발급한 AppID가 있을 경우 기존 것을 사용해도 무방함
  • 결제용 앱아이디
    • 게임 AppID 선택
    • OS – Windows, 마켓 – 직접 배포 선택

② 웹 로그인 앱아이디의 상세 정보를 설정합니다.

  • 로그인 정보에 IdP 키 값을 모두 입력
  • 로그인 IdP 사용 설정
  • 로그인 동작 설정에서 redirect URI에 로그인 후 돌아갈 사이트 주소를 입력

③ 콘솔 > 빌링 > 결제 환경 설정 > PG 설정에서 PG 정보를 등록합니다.

④ 콘솔 > 빌링 > 인앱 결제 > 마켓 PID 등록에서 1번에서 생성한 결제용 앱아이디에 마켓PID를 등록합니다.

⑤ 웹 로그인 API와 웹 PG결제 API로 사이트를 개발합니다.

사전 작업

1. PG결제 플랫폼 설정

  • 포트원를 사용할 경우
    • 포트원 관리자 콘솔에 IAP 서버 콜백 URL 등록 및 PG사 설정
      • 포트원 관리자 콘솔 > 시스템 설정 > 웹훅 설정 내 웹훅 발송 공통 URL 등록
    •  웹훅 URL
      • 상용 : https://store.withhive.com/payment/result_processing/import
      • 샌드박스 : https://sandbox-store.withhive.com/payment/result_processing/import
    • 주의 사항
      • 포트원에서는 샌드박스 결제 테스트를 제공하지 않으므로 테스트를 위해서 아래와 같은 방법을 제안합니다.
      • 포트원 계정을 상용서비스, 테스트용 2개를 생성합니다. 포트원 콘솔용 관리자 계정은 실제 계약과 상관없이 계정을 생성할 수 있습니다.
      • 포트원 상용 계정에는 상용 URL을 등록하고, 상용 콘솔에 실제 서비스하는 PG사 정보등을 등록합니다. 
      • 포트원 테스트 계정에는 샌드박스 URL을 등록하고, 샌드 박스 콘솔에는 테스트용 PG사 정보등을 등록합니다. 
      • 만일 실제 포트원 계정을 상용 서비스용으로 1개만 사용시에는 최초 적용시 샌드박스로 연결하여 테스트 후 정식 서비스때 상용 URL로 바꾸도록 합니다.
      • 상용 URL 로 변경한 후에는 절대 샌드박스 주소로 변경해서는 안됩니다. 실제 유저 결제도 테스트 결제로 처리되므로 반드시 주의해주세요.
      • 포트원 콘솔에서 PG사를 테스트로 설정한 경우, 결제한 내역은 익일 자동 취소됩니다. 상용 서비스 중인 게임은 절대 테스트로 설정해서는 안됩니다.
  • Xsolla를 사용할 경우
    • Project ID와 Secret Key 발급은 별도 문의해 주세요.
  • MyCard와 직접 계약하여 사용할 경우
    • 콘솔 > PG 설정에서 서비스 국가를 MyCard로 선택하고 해시키 생성합니다.
    • MyCard에서 제공한 Registration Form에 콘솔에서 발급한 해시키와 결제를 위한 IP, URL, 및 고객사별 등록 정보 입력하여 MyCard에 제출합니다. IP와 URL정보는 아래 첨부 파일을 다운받으세요.
      IP&URL 정보 다운로드
    • 이 후 MyCard에서 FaServiceID를 받아 콘솔의 PG사 설정에 입력합니다.
    • 참고사항
      • 결제 수단별 통화에 따라 최저 및 최고 결제 금액이 지정되어있으므로 상품 가격  설정시 해당 사항에 주의가 필요함
        • 해당 금액 범위에 벗어난 상품의 경우 결제 요청시 에러메세지가 노출됨

2. 콘솔 설정

  • Price Tier 설정
  • 마켓 PID 등록
    • 메뉴 위치 : 콘솔 > 빌링 > 인앱 결제> 마켓 PID 등록
    • 마켓 PID 등록 가이드 바로가기
  • PG결제 설정

PG 설정 가이드

PG 설정 방식

AppID를 기준으로 PG 정보를 설정할 수 있으며 아래와 같은 설정 방식을 지원합니다.

Note
  • AppID의 마켓 정보가 '직접 배포(direct)'인 경우에만 PG 설정 목록에 표시되며, 그 외 AppID는 노출되지 않습니다.

개별 설정

image

  • AppID 1개의 PG 정보를 설정합니다.
  • 해당 AppID의 수정 아이콘 또는 AppID 선택 후 수정 버튼을 클릭하면 PG 설정 페이지로 이동합니다.

일괄 설정

image

  • 선택한 AppID 전체에 동일한 PG 정보를 일괄 적용할 수 있습니다.
  • 선택한 모든 AppID에 동일한 PG 정보를 적용하려면, 원하는 AppID를 선택한 뒤 수정 버튼을 클릭해 주세요.
  • 일괄 설정 시에는 AppID별 기존 설정이 서로 달라, 기존 정보를 자동으로 불러올 수 없습니다.
  • 필요한 경우 기존 설정 불러오기 버튼을 눌러, 특정 AppID의 PG 정보를 불러와 설정을 진행해 주세요.
  • 설정을 저장하면, 현재 입력한 PG 정보가 선택한 AppID 전체에 적용됩니다.

기존 설정 불러오기

PG 설정 중 다른 AppID의 정보를 참고하거나 적용하려면 기존 설정 불러오기 기능을 사용하세요.

image

image

  • 버튼을 클릭해 원하는 AppID를 선택하면, 해당 AppID의 PG 설정 정보를 그대로 불러옵니다.

image

  • 불러온 후에는 각 PG 플랫폼 설정 팝업에 들어가 반드시 저장을 완료해 주세요.

 

서비스 국가 선택

PG 플랫폼별로 서비스할 국가를 선택할 수 있습니다. 선택한 국가에서만 해당 PG 플랫폼을 통해 결제를 진행합니다.

image

Note
  • 한 국가당 1개의 PG 플랫폼만 서비스할 수 있으며, 한 국가에서 여러개의 PG 플랫폼을 동시에 서비스할 수 없습니다.
  • 예시: PortOne 서비스 국가를 ‘대한민국(KR)’ 선택 -> Mycard, Xsolla에서 ‘대한민국(KR)’ 선택 불가

PG사 설정

PortOne 설정

image

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

image

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

MyCard 설정

image

  • 기본 정보
    • MyCard에서 제공한 FacServiceID를 입력합니다.
    • 인증 번호(Hash) Key는 자동 생성 버튼을 클릭해 생성해 주세요.
    • 생성된 인증 번호(Hash) Key를 복사해 MyCard 등록 요청서에 기입한 뒤 MyCard로 제출해 주세요.
    • MyCard에 이미 등록된 인증 번호(Hash) Key를 사용하려면, 해당 값을 그대로 입력하면 됩니다.
  • 결제 수단 정보
    • 결제 수단은 Mycard만 제공됩니다.

Xsolla 설정

image

  • 기본 정보
    • Xsolla 콘솔  > 프로젝트 설정 > 일반 설정의 프로젝트 ID와 Secret Key를 정확히 입력해 주세요.
  • 결제 수단 정보
    • 이용할 결제 수단을 선택합니다.
    • 국가를 선택해 국가별로 지원하는 결제 수단을 확인할 수 있습니다.
    • 미리보기를 통해 국가별로 노출되는 결제 수단을 미리 확인할 수 있습니다.
      • 국가를 선택한 경우 그 국가에서 지원하는 결제 수단 중 활성화된 항목한 미리보기에서 확인할 수 있습니다.
      • 국가를 선택하지 않고 미리보기를 확인하는 경우 서비스 국가에서 처음 선택한 국가 기준으로 결제 수단을 확인할 수 있습니다.

PG 결제 알림 설정

결제 성공 또는 취소가 발생하는 즉시 해당 결제 정보를 입력한 URL로 전송합니다. 게임은 해당 결과를 사용해 영수증을 검증한 후 유저에게 상품을 지급할 수 있습니다. 구성 서버가 없을 시 입력하지 않아도 되며, 이 경우 게임에서 직접 아이템 미지급 결제건을 조회해 영수증 검증 프로세스를 진행해야 합니다.

image

  • 결제 완료 정보 : 결제 성공 또는 취소가 발생하는 즉시 결제 완료 정보(성공, 취소)를 입력한 URL로 전송합니다.
  • 모든 결제 정보 : 결제 성공 또는 취소가 발생하는 즉시 모든 결제 정보(성공, 취소, 환불 유저 재결제)를 입력한 URL로 전송합니다.

PC결제 조회 및 취소

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

  • PG사와 결제 수단

    • PG사 설정에서 결제수단 활성화 여부와 상관없이 해당 업체에서 제공하는 모든 PG 목록을 선택옵션으로 제공합니다.
  • 상태

    • PG

      • 결제 완료 – 결제가 정상적으로 완료된 건
      • 결제 실패 – 결제 중 오류 등으로 인한 실패
      • 결제대기- 계좌이체등으로 인해 즉시 결제가 이뤄지지 않은 경우
      • 취소 요청 – 결제 취소 요청한 건
      • 취소 완료 – 정상적으로 결제 취소 된 경우. 터미널3 결제건은 취소 완료 여부 확인 불가
      • 취소 실패 – 취소 요청을 하였으나 실패한 건
      • 미진행 – 유저가 결제전에 결제창을 닫거나 결제 취소를 클릭하여 결제가 완료되지 않은 건
    • 스팀

      • 주문접수
      • 결제승인(사용자)
      • 결제 완료
      • 결제 취소
      • 결제 실패
      • 결제환불
      • 결제부분환불
      • 불법결제
      • 주문사기
      • 지불거절사기
      • 기타
      • 결제취소실패
  • 총 결제 금액 : 미진행을 제외한 검색 조건 전체 합계

  • 구매 완료 횟수 : 취소 건을 제외한 결제 완료된 건 수
  • 총 취소 금액/취소 횟수 : 취소 완료된 총 금액과 건 수
  • 상품 금액 : Price Tier에서 설정한 표시 통화의 상품 금액
  • Game_Payload_info : 아이템 지급 결과 전송 API를 통해 애널리틱스에서 추가 지표로 활용하기 위해 게임 서버로부터 * 전달 받는 값
  • IAP_Payload : 앱 개발자가 자체 정의한 구매 메타데이터
  • 주의 사항
    • PG사 설정에서 옵션값을 변경하면 변경전 설정값으로 결제한 내역은 콘솔에서 취소가 안될 수 있습니다.
      • 예1: PG사 설정에서 Xsolla를 사용하다 PortOne로 변경하면, 기존 Xsolla 결제 내역은 콘솔에서 취소 불가
      • 예2: PG사 설정에서 Tier 코드를 사용하다가 삭제한 경우, Tier 코드 사용 시점에 결제된 내역은 콘솔에서 취소 불가
    • PortOne 콘솔에서 결제 내역을 직접 취소할 경우 PG사에 따라 콘솔로 취소내역을 전송하지 않을 수 있으므로 가급적 콘솔을 통해서 취소를 진행

PC결제 아이템 재처리

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

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

디지털 미디어에 대한 소비자 보호법(AB 2426) 대응

image

  • 미국 캘리포니아 주 '디지털 미디어에 대한 소비자 보호법(AB 2426)’ 시행으로 디지털 콘텐츠 구매 시 소비자에게 이를 실제로 소유하지 않는다는 사실을 알리는 것을 의무화 하고 있어 PG 결제 UI 내 관련 정책을 준수하는 문구를 노출합니다. 해당 문구는 국가 미국, 언어값이 en일 경우에만 노출됩니다.
  • Learn more 클릭 시 콘솔 > 프로비저닝 > 약관에서 설정한 이용약관 링크가 연결됩니다.