본문으로 건너뛰기

ONE Store 관리상품의 소모성 상품 구매

개요 & 사전지식​

  • ONE Store ‘관리상품의 소모성 형태의 상품 구매’를 위한 빌링 서버측의 상세 가이드 문서입니다.
    • ONE Store 인앱 상품 유형은 ‘관리형 상품’과 ‘구독형 상품’이 존재하는데(참고 링크), ‘관리형 상품’의 소모성 BM 사용에 대해서 지원합니다.
    • 관리형 상품을 응용하여 영구성, 기간제로도 사용 가능하지만 일반적으로 게임에서 상품 전시 방식으로 처리되고 있어서 지원하지 않습니다.

  • ONE Store가 Windows 환경 지원을 위해 기능이 확장되었지만, 빌링 시스템은 현재 Android만 지원합니다.
정보
  • Windows는 결제 및 클라이언트 배포 방식이 Android와 상이하고 현재 요구된 필요성이 없어서 Windows는 지원하지 않습니다.
  • 한도제한, 지표 분석 등에서 PC와 구분이 필요하여 APP_STORE 코드가 세분화됩니다.
    • ONE_STORE_ANDROID, ONE_STORE_WINDOWS(현재 기능으로는 미 제공 중)

  • ONE Store가 기존 한국 외 글로벌까지 지원이 확대되었으며, 빌링 시스템은 해당 부분을 고려하여 지원합니다.
    • 예) ONE Store가 UTC+9, UTC+0로 작동되는 부분에 대해서 빌링 시스템에서 로직 처리

ONE Store 개발자센터 설정 및 빌링시스템에 연동​

  • ONE Store 개발자 센터 (Link) -> 대상 상품 -> 라이선스 관리 -> OAuth 정보 메뉴에서 'Server API' 키 정보를 확인 가능합니다.
  • 확인된 OAuth 정보를 담당자에게 전달 후 빌링시스템에 등록합니다.

시퀀스 다이어그램​

정보

3-10 빌링 완료 요청을 누락한 경우와 같은 분산 데이터 정합성 문제 발생에 대한 처리방법 팁

  • VERIFY_SUCCESS 상태로 방치되어 있을 수 있습니다.
  • 해당 boid 리스트를 빌링 구매 리스트 조회 API를 이용해서 상태값 등을 확인 후 이후 시퀀스를 진행하여 정합성이 깨진 데이터를 완료 처리하거나 게임 로직 처리가 가능합니다.

참고​

테스트 결제 방법​

정보

테스트 결제 방법 요약

  • Sandbox 및 상용환경에서 테스트하기 위해서는 사전에 원스토어 ID를 테스트 ID로 등록
    • QA 조직, 외부 개발사 등의 라이브 환경의 테스트ID는 잘 관리하여 미 결제 → 재화 획득의 운영사고를 막아야합니다.(관리 감독 필요)
  • 테스트 ID는 원스토어 사용자 ID로, 원스토어에 회원으로 등록되어 있는 ID를 조회하여 등록
  • 상용테스트 환경에서 결제를 하실 경우 취소하지 않으면 과금이 발생할 수 있으니, 결제 테스트 후 반드시 결제취소를 진행