PG 결제

PG(Payment Gateway) 결제는 외부 결제 대행사(PG사)의 시스템과 연동해 신용카드, 계좌이체, 가상계좌 등 다양한 결제 수단을 제공하는 기능입니다. 스토어 수수료를 절감하고 특정 국가나 플랫폼 환경에 맞춘 결제 수단을 사용자에게 제공합니다.

Hive Axyl이 지원하는 PG사는 PortOne, Xsolla, MyCard 등입니다. 'PG 결제'는 소모성 상품의 단건 결제와 복수 결제를 지원합니다. 구독 결제는 지원하지 않습니다.

WebGL 지원

WebGL에서는 스토어 결제 Add-on을 사용할 수 없으며 PG 결제만 지원합니다. 결제 상품에는 실행 환경이 Web이고 스토어가 직접 배포인 App ID를 연결하세요. App ID를 생성하고 실행 환경과 스토어를 설정하는 방법은 App ID 생성을 참조하세요.

결제 주문 요청의 OS에는 OrderRequestOs.Webgl을 지정하세요. 결제 요청은 로그인 세션을 사용합니다. Hive Axyl SDK 1.0.1부터 WebGL 결제 요청이 401 응답을 받으면 자동 토큰 갱신을 완료한 뒤 갱신된 토큰으로 원래 요청을 다시 처리합니다. AuthTokenRefresh.Enable()을 사용하는 WebGL 앱은 SDK를 1.0.1 이상으로 업데이트하세요. 설정 방법은 액세스 토큰 자동 갱신을 참조하세요.

결제 흐름 확인

먼저 결제 모듈을 설치하고 초기화한 뒤, 사용자가 결제할 수 있도록 로그인 세션을 생성합니다. 이후 PG 결제 흐름은 아래와 같습니다.

순서	단계	주체	설명
1	연동 환경 구성	앱 클라이언트	Hive 콘솔에서 PG사를 설정하고, 결제 모듈을 확인합니다.
2	상품 목록 조회	앱 클라이언트	Hive Axyl 서버에 등록된 PG 상품 정보를 조회하여 사용자에게 노출합니다.
3	상품 구매	앱 클라이언트	결제 페이지 URL을 생성하고 외부 브라우저에서 결제를 진행합니다.
4	영수증 검증	앱 클라이언트, 앱 서버	앱 클라이언트가 미지급 주문을 조회해 영수증을 앱 서버에 전달하고, 앱 서버가 Hive Axyl Server API로 영수증을 검증합니다.
5	상품 지급	앱 서버, 앱 클라이언트	영수증 검증이 완료되면 앱 서버가 상품을 지급하고, 앱 클라이언트가 구매 완료 처리를 수행한 뒤 지급 결과를 기록합니다.

다음 단계

PG 결제 연동 환경을 구성합니다.