GS2-Money2 API 레퍼런스

과금 통화 관리 기능

게임 내 리소스 중 현금에 상당하는 가치를 가지는 과금 통화를 관리하는 서비스입니다.

과금 통화란 일본의 자금결제법에 정의된 선불식 지급 수단(자가형)에 해당하는 게임 내 통화를 의미합니다.
자금결제법을 준수하기 위해 GS2-Money2에서는 잔액을 단순한 수량으로 다루지 않고, 구입 시점의 단가별로 구분하여 관리합니다.
예를 들어 100엔에 100개를 구입한 경우에는 단가 1엔, 1000엔에 1200개를 구입한 경우에는 단가 0.8334엔으로 보유합니다.
하나의 월렛에서 JPY·USD 등 여러 통화로 구입한 과금 통화를 보유할 수 있으므로, 통화별 매출과 소비를 개별적으로 파악할 수 있습니다.

입출금은 모두 트랜잭션으로 기록되며, 미사용 잔액은 하루에 여러 번 집계되므로 선불식 지급 수단의 공탁 대응에 활용할 수 있습니다.

Apple App Store·Google Play가 발행한 영수증은 정규 영수증인지, 이미 사용된 것은 아닌지를 검증한 뒤 잔액에 반영하므로 부정한 영수증에 의한 입금을 방지할 수 있습니다.
개발 중에는 더미 영수증(fake)을 사용할 수도 있습니다.
스토어의 정기 구독(구독)도 지원하며, 계약의 시작·갱신·종료를 자동으로 반영합니다.
계약 상태는 다른 계정으로 인계할 수도 있으므로, 가족 공유나 자녀 계정에서 성인 계정으로의 이전에도 대응할 수 있습니다.

유상으로 구입한 통화와 캠페인 등으로 무상 제공한 통화는 동일한 월렛 내에서 구분하여 관리되며, 소비 시에 어느 쪽을 우선하여 소비할지 선택할 수 있습니다.
유상 과금 통화를 소비하는 경우에는 입금 시기가 오래된 것부터 순서대로 소비됩니다.

서로 다른 플랫폼 간에 지갑을 공유하고 싶지 않은 경우, 접속한 플랫폼에 따라 동일 계정 내의 지갑을 슬롯으로 분리하는 구조도 제공합니다.
이는 다른 플랫폼에서 구입한 과금 통화의 반입을 금지하는 플랫폼 가이드라인에 대응하기 위한 것입니다.
그 경우에도 무상 제공분은 서로 다른 플랫폼 간에 공유할 수 있습니다.


GS2-Money2 SDK for Game Engine API 레퍼런스

게임 엔진용 GS2-Money2 SDK의 모델 사양과 API 레퍼런스

GS2-Money2 SDK API 레퍼런스

각종 프로그래밍 언어용 GS2-Money2 SDK의 모델 사양과 API 레퍼런스

GS2-Money2 스크립트 트리거 레퍼런스

확장 스크립트를 호출하는 이벤트 트리거의 레퍼런스

GS2-Money2 Deploy/CDK 레퍼런스

GS2-Deploy의 스택을 생성할 때 사용하는 템플릿 포맷과, CDK를 이용한 각종 언어의 템플릿 출력 구현 예제

GS2-Money2 마스터 데이터 레퍼런스

마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스

GS2-Money2 트랜잭션 액션

검증/소비/입수 각 트랜잭션 액션의 사양

GS2-Money2 Buff 레퍼런스

GS2-Buff로 버프를 적용할 때 지정하는, 파라미터 보정이 가능한 모델/액션 내 필드와 그 적용 범위 설정에 대해