Introduction

이 문서는 유저 결제 완료 후 STOVE 빌링 미들웨어가 게임서버로 전달하는 아이템지급 요청에 대한 데이터 처리 방법을 안내 합니다. 본 기능은 스토브 빌링 시스템 사용시 게임 서버에서 필수로 구현해야 합니다. 호출 방식은 RESTful API 형태로 호출되며, 전달되는 정보는 아래 API 기본 정보를 참고해 주세요.

유저 결제가 완료되면 STOVE 빌링 미들웨어는 파트너스에 등록 된 게임 서버 URL 주소로 아이템 지급에 필요한 상품정보 와 게임 아이템 정보(Json)를 전달 합니다.

게임 서버는 해당 지급 정보를 수신 -> 유저에게 지급 처리 -> 빌링 미들웨어 지급 결과를 응답 해줘야 합니다.

주의) API로 전달한 TID(스토브 빌링 결제 주문번호)는 게임 서버에서 저장 후 관리하여 중복지급이나 미지급이 발생되지 않도록 해야 합니다.

**#Basic information**

POST 파트너스 통해 URL 등록
Host:
   <https://I-api.onstove.com> (LIVE)    
   <https://I-api.gate8.com> (SB)
Content-Type: application/json

파트너스 URL 등록 위치

스토브 담당자에게 문의 부탁드립니다.

Request

Header

Name Type Required Default Value Example Description
caller-id String Y - clientapp API 호출자 정보

Path Variable

Name Type Required Default Value Example Description
service_id String Y - STOVE_QA Game_id

Body

Name Type Required Default Value Example Description
bill_platform_type string(16) Y - 결제한 플랙폼 타입(유효성 체크 시 필요)
-MOBILE : 모바일 빌링
-ONLINE : 온라인 빌링
-SHOP: 상점
noti_type string(32) Y - notification 구분
-ONLINE_PURCHASE : 온라인일반상품 구매
-IAP_PURCHASE : 모바일 일반상품 구매
-IAP_SUBSCRIPT : 모바일 구독상품 구매
-IAP_OOAP : 모바일 OOAP 상품 구매
world_id string(30) N - 월드(서버) 구분
member_no long Y - 회원 번호
character_no string(20) N - 게임 캐릭터 별로 발급되는 키값(STOVE에서 발급)
txn_time long Y - 결제 시각(Unix Timestamp UTC-0)
data json object Y - 상세 데이터

Data(온라인 일반 상품)

Name Type Required Default Value Example Description
tid string(20) Y - T202202103125 스토브 빌링에서 발급한 주문번호
product_id string(20) Y - p1002 스토브 플랫폼에 등록한 상품 코드
product_currency string(3) Y - KRW, USD Currency of the amount해당 금액의 통화
product_price decimal Y - 1100, 0.99 거래 금액
inservice_item_id string(30) Y - cp7892 게임내 아이템ID
service_order_id string(20) N - 결제요청시 결제 서버에 전달한 게임 payload(현재 미지원 Spec)

Data(모바일 일반상품 / OOAP 상품)