PG 결제

PG 결제는 상품 목록 조회와 구매만 지원하며, 클라이언트 기반 영수증 검증을 진행하지 않습니다. Windows 환경에서 PG 결제로 구매하는 경우에는 호출 즉시 새 창에서 결제 요청 화면이 표시됩니다.

hive.IAPV4.purchase(marketPid, iapPayload, onIAPV4PurchaseCB)를 호출하면 영수증 정보 없이 onIAPV4PurchaseCB를 통해 ErrorCode:IAPSUCCESS=90와 Code:IAPV4HiveStoreSuccess=-6110000의 응답을 즉시 반환하며, ErrorCode(또는 Code)를 판별하여 게임 내에서 구매 중임을 알리는 팝업을 노출하면 됩니다.

Hive IAP v4에서 지원하는 PG 결제를 적용하기에 앞서 Hive PG 결제 정책을 확인하고, PG 결제 콘솔 가이드 사전 작업 내용에 따라 콘솔에서 필요한 정보를 등록하세요.

Hive PG 결제 특징¶

Hive PG 결제의 주요 특징은 다음과 같습니다.

Hive PG결제는 Hive SDK V4와 Hive IAP V4를 기반으로 하며, 결제 대행사(PG)에서 제공하는 웹 브라우저를 통해 비동기 방식으로 처리됩니다.
- 제공되는 API는 모두 게임 서버를 통해서만 호출할 수 있습니다.
사전에 콘솔에 등록한 정보는 상점 구성에 필요한 상품 가격 및 상품 정보에 반영되며, 상품에 대한 정보는 Hive SDK v4를 통해 전달됩니다.
콘솔에서 등록한 결제 결과를 받을 URL로 결제 결과가 전송됩니다. 결제 수단에 따라 결제 결과를 즉시 전달할 수 없는 상황이 존재합니다. (예: 가상 계좌 입금)
지급이 완료된 주문은 반드시 지급 완료 처리 API를 통해 상품 지급 완료 처리를 해야 합니다.
- 결제는 완료되었으나 지급 완료 처리가 되지 않은 상품을 재구매하고자 할 때에는 결제가 진행되지 않습니다. 이전 구매 상품의 지급 완료 처리 후에 재구매할 수 있습니다.
- 결제를 완료하지 않은 상태에서 여러 개의 결제창을 띄워 결제를 시도하는 경우와 같이 지급 완료 처리되지 않은 상품의 추가 구매를 시도하면 최초 1건의 결제만 완료되며, 나머지 구매 건은 결제가 되더라도 자동 취소됩니다.
- 지급 완료 처리 요청을 하더라도 게임 서버의 판단에 따라 결제가 취소될 수 있습니다.

Hive PG 결제 과정¶

Hive PG 결제는 다음의 순서로 진행됩니다. 아래 내용을 구현하려면 PG 결제 API 를 게임 서버에서 연동합니다.

결제 완료 내역 조회
영수증 검증
상품 지급 완료 처리

이용자의 결제 완료 이력이 존재하는 경우에는 반드시 영수증 검증과 상품 지급 완료 처리를 순서대로 진행해야 합니다. 상품 지급 완료 처리된 결제 내역은 결제 완료 내역 조회에서 더 이상 노출되지 않습니다.

더 자세한 Hive PG 결제 과정은 아래의 도식도를 참고하세요.

Hive PG 결제 과정 도식도

Hive PG 다중 수량 구매¶

Hive PG 결제는 구매 요청 시 수량을 지정하여 한 번의 결제에서 동일한 앱 내 상품을 두 개 이상 구매할 수 있습니다.

수량을 지정할 수 있는 quantity 파라미터가 포함된 hive.IAPV4.purchase(marketPid, iapPayload, quantity, onIAPV4PurchaseCB)를 사용하여 구매할 수 있도록 합니다. 다중 수량은 소모성 인앱 상품, 구매, 소비, 재구매가 가능한 상품을 위한 것입니다. 반복적으로 구매하지 않도록 의도된 상품에는 주의해 주세요.