PG(Payment Gateway)를 이용한 인게임 결제

개요

• PG를 이용해서 게임내 상품을 판매 가능합니다.

• 빌링 시스템은 PG와 계약 후 기능을 랩핑해서 제공해드리고 있습니다.

  • 2025년 2월 기준 토스페이먼츠 제공 중

결제 후 상품 지급 방법 결정

• 빌링 시스템에서는 외부 결제 후 상품 지급을 위해서 2가지 방법을 제공 중입니다.

• 아래 2가지 방법 중 결정 후 개발이 필요합니다.

상품 지급 API 연동

• 상품 지급 API를 정의서에 맞게 개발 후 빌링 시스템에 전달 → 결제 성공되면 해당 API를 호출하여 상품이 지급

보상 인벤토리 시스템

• 결제 후 ‘보상 인벤토리 시스템’에 빌링 시스템이 상품 추가 → 게임서버가 적절한 시점에 해당 시스템의 API를 이용해서 상품 지급

보상 인벤토리 시스템이란?

• 게임쪽에서 특정 시점에 주도적으로 지급 대상 상품 목록을 가져가는 방식의 기능을 제공하는 시스템

• 게임 점검 또는 오류 발생으로 상품 지급 API가 실패할 수 있는데, 인벤토리 시스템을 이용하면 게임 서버가 주도적으로 처리 가능

• 상품 지급 API 연동 방식보다는 작업양이 많을 수 있음

시퀀스 다이어그램

실제 유저에게 판매할 상품의 전시(판매 기간, 유저 조건 특화 판매 등) 관리는 게임쪽에서 담당합니다.

• 다만, 빌링 시스템에서 판매 가능한 상품의 등록 기능을 제공합니다.

  • 빌링 시스템에 판매 상품을 먼저 등록해야 PG로 결제가 가능합니다.(예. 구글 플레이 스토어에 상품 등록이 선행되어야 결제 가능한 것과 동일)

  • 일반적으로 사업PM을 통해서 상품 등록은 진행됩니다.

• 등록된 상품 리스트를 게임 서버에서 조회 후 실제 유저에게 판매할 상품 리스트를 필터링(상품 전시) 후 판매하시면 됩니다.

  • 이때, 상품 가격과 상품명의 로컬라이징은 SDK를 통해서 제공되어 다른 결제 수단과 동일한 방식으로 구현 가능하십니다.

시퀀스 관련 추가 설명

• 1-2. 게임서버가 빌링 시스템에 등록된 PG 판매 가능 상품 리스트를 조회하는 API(링크)

  • payment 파라미터 PG로 요청하여 PG로 판매 가능한 상품 리스트를 페이징으로 조회 가능

• 1-6. SDK에서 사용하는 PG 상품의 가격 및 상품명 조회

  • 빌링 GW를 통해서 SDK가 직접 호출하며, 게임 클라이언트 개발자는 제공되는 랩핑된 메소드를 이용해서 구현

  • 상세 내용은 SDK 가이드를 확인

• 2-2. 게임서버는 빌링에 구매 예약 및 유저의 결제 URL 요청(링크)