콘텐츠로 이동

PortOne

PortOne을 통해 PG 결제 서비스를 제공하려면 설정이 필요합니다. App ID를 기준으로 서비스할 국가 설정과 결제 수단을 연결하고 관리합니다.

준비사항

PortOne 관리자 콘솔에 접속하여 결제 처리에 필요한 결제 알림(Webhook) URL 등록이 반드시 필요합니다.
빌링 서버는 PortOne에서 결제가 완료되는 즉시, 결제 알림(Webhook) URL을 통해 전송받은 데이터를 검증하여 무결성이 확인된 경우에만 최종적으로 결제를 완료 처리합니다. 설정이 누락되면 결제가 처리되지 않으므로, 아래 순서에 따라 설정을 완료해 주세요.

설정 방법:

  1. PortOne 관리자 콘솔에 진입합니다.
  2. 결제 연동 > 연동 정보 로 이동합니다.

  3. 결제 알림(Webhook) 관리 탭을 클릭하여 아래와 같이 URL을 등록합니다.

    image

  4. 실연동, 테스트를 구분하여 PortOne 관리자 콘솔에 URL을 정확히 입력하세요.

  5. PortOne 콘솔에서 PG사를 테스트로 설정한 경우, 결제한 내역은 익일 자동 취소됩니다. 상용 서비스 중인 게임은 실연동으로 설정해야 합니다.

PG 설정하기

PortOne 정보를 연동하여 서비스 국가별로 사용할 결제 수단을 설정합니다.

➡️ 콘솔 경로: 빌링 > 결제 설정 > PG 설정

  1. PG 설정이 필요한 App ID의 '수정' 아이콘을 클릭하거나, App ID를 선택한 후 [수정] 버튼을 클릭하면 PG 설정 페이지로 이동합니다. 여러 App ID에 동일한 PG 설정을 적용하려면 원하는 App ID를 모두 선택한 뒤 [수정] 버튼을 클릭하세요. 선택한 App ID에 동일한 설정이 일괄 등록됩니다.

    image

  2. PG 설정 페이지로 이동해 서비스 국가 및 상세 설정을 진행합니다. 만약 다른 App ID의 PG 설정 정보를 불러와 덮어쓰기 하려는 경우 [기존 설정 불러오기] 기능을 활용합니다.

    image

  3. PortOne을 어느 국가에서 서비스할지 선택합니다.

    • 하나의 국가는 하나의 PG 플랫폼만 연결됩니다. 예를 들어, ‘대한민국’에는 PortOne, Xsolla, MyCard 중 하나의 PG 플랫폼만 선택하여 서비스를 제공할 수 있습니다.
    • 서비스 국가를 설정했다면 [PortOne 설정] 버튼을 클릭해 상세 설정을 진행합니다.

    image

  4. PortOne 결제 연동에 필요한 기본 정보를 입력합니다.

    image

    • PortOne 관리자 콘솔 > 결제 연동 > 연동 정보 > V1 API 에 접근하여 고객사 식별 코드, REST API key, REST API Secret 정보를 확인하고 Hive 콘솔에 동일하게 입력하세요.
    • PortOne에서 프로젝트 하나에 다양한 결제 채널을 운영하려고 하위 상점을 생성했다면, PortOne 관리자 콘솔 > 설정 > 하위 상점 관리 > 티어 코드에서 정보를 확인 후 Hive 콘솔에 티어 코드를 입력합니다.
    • 네이버페이를 사용한다면, Chain Id를 입력합니다. Chain Id는 네이버페이와 계약 시 받을 수 있습니다.

    [PortOne 관리자 콘솔] image
    image

  5. 고객사 식별 코드, REST API key, REST API Secret 정보가 입력되면 결제 수단 정보 영역에 PortOne 관리자 콘솔에 등록된 정보를 자동으로 불러와 표시합니다. 선택 가능한 결제수단 목록에서 사용자에게 서비스할 결제 수단을 선택합니다.

    image

    • 하나의 결제 수단은 하나의 PG사만 연결하여 사용합니다. 예를 들어, KG이니시스에서 신용카드를 선택했다면, 다른 PG사에서는 신용카드를 선택할 수 없습니다.
    • [미리보기] 버튼을 클릭하면 선택한 결제 수단으로 테스트 결제 페이지가 실행됩니다. 결제가 정상적으로 이루어지는지 확인하세요.
    • PG사 계약 과정에서 결제 테스트 페이지가 필요한 경우, 미리보기 페이지의 URL을 복사해 PG사에 전달하여 활용합니다.

다음 단계

PG 결제를 위한 모든 설정 단계가 완료되었습니다.
Hive SDK v4.25.1.0 미만을 사용 중이거나 하이브 웹 상점을 서비스 하는 경우, '결제 알림 설정'까지 완료해야 PG 결제 서비스를 위한 모든 준비가 완료됩니다. 자세히 보기