상품 구매 여부 API 요청 (옵션)

웹샵 상품 구매 가능 여부 게임 서버 검증 기능 가이드

웹샵에서 상품을 선택할 때, 게임 서버를 통해 해당 상품의 구매 가능 여부를 검증하는 기능입니다. 일반적으로 모든 상품이 이 검증을 거칠 필요는 없으며, 아래와 같은 특정 상황에서 필요합니다.

검증 기능이 필요한 경우

1. 상품별로 구매 가능한 게임 유저를 구분해야 하는 경우

   • 예: 특정 등급 이상의 유저만 구매 가능

   • 예: 특정 퀘스트를 완료한 유저만 구매 가능

   • → 유저의 게임 내 상태에 따라 구매 가능 여부를 서버에서 실시간으로 판단합니다.

2. 복잡한 구매 조건으로 웹샵에서 구현이 어려운 경우

   • 예: 유저가 보유한 게임 내 재화의 복잡한 계산이 필요한 경우

   • 예: 유저의 게임 진행 상황에 따라 구매 조건이 달라지는 경우

   • → 게임 서버의 데이터와 로직을 이용해 정확하게 조건을 검증합니다.

3. 상품 구매 가능 여부가 날짜가 아닌 특정 이벤트로 결정되는 경우

   • 예: 특정 이벤트가 활성화되어 있을 때만 상품 구매 가능

   • 예: 반대로 특정 이벤트 기간에는 상품 구매를 제한

   • → 게임 내 이벤트 트리거에 따라 실시간으로 구매 가능 여부를 관리합니다.

4. 그 외 복잡한 기능이 필요한 경우

   • 예: 유저마다 1회 한정 구매

   • 예: 구매 횟수에 따라 할인 적용 등 복잡한 정책이 필요한 경우

   • → 게임 서버에서 유연하게 확장 가능하도록 설계할 수 있습니다.

검증 API 요청

POST /product

상품D 가 유효한지 확인하는 웹훅 입니다.

Headers

Name	Value
Content-Type	application/json
X-API-KEY	API KEY

Body

Name	Type	Description	Example
userID	string	고객이 입력한 사용자ID	playerID
serverID	string	서버ID (필요한 경우)	serverID
amount	number	상품가격	1.99
currency	string	통화	USD
method	string	서브 결제 수단	100000
productID	string	상품ID	com.game.item.001
paymentID	string	결제수단ID	kcp

Response

200

{
  "status": 1,
  "message": "OK"
}

400

{
  "status": -1,
  "message": "error message"
}