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 설정
- 메뉴 위치 : 콘솔 > 빌링 > 스토어 가격 관리 > Price Tier
- Price Tier 설정 가이드 바로가기
마켓 PID 등록
- 메뉴 위치 : 콘솔 > 빌링 > 인앱 결제> 마켓 PID 등록
- 마켓 PID 등록 가이드 바로가기
PG결제 설정
- 메뉴 위치 : 콘솔 > 빌링 > 결제 환경 설정 > PG 설정
- PG 설정 가이드 바로가기

PG 설정 가이드¶

PG 설정 방식¶

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

Note

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

개별 설정¶

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

일괄 설정¶

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

기존 설정 불러오기¶

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

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

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

서비스 국가 선택¶

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

Note

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

PG사 설정¶

PortOne 설정¶

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

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

MyCard 설정¶

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

Xsolla 설정¶

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

PG 결제 알림 설정¶

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

결제 완료 정보 : 결제 성공 또는 취소가 발생하는 즉시 결제 완료 정보(성공, 취소)를 입력한 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) 대응¶

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