웹 상점 구매 제한 검증

Hive 콘솔 > 커뮤니티 & 웹 상점 > 웹 상점 > 상품 관리에서는 웹 상점 상품에 계정별 구매 제한과 구매 수량 제한을 설정할 수 있습니다. 그리고 두 설정 각각에 최대 구매 수량을 설정할 수 있습니다.

웹 상점 구매 제한 검증은 웹 상점에서 결제한 상품이 위 두 설정에 있는 최대 구매 수량을 초과했는지 검증하는 작업입니다. 여기에서는 이 작업을 위해 웹 상점 결제 정보 검증 API를 제공합니다.

개요¶

웹 상점 결제 정보 검증 API 호출을 포함한 웹 상점 구매 제한 검증 전체 과정을 요약하면 아래와 같습니다.

1. 앱 개발사: PG 결제 구현과 PG사 설정을 참고해 웹 상점에서 앱 사용자가 PG 결제 시 상품을 지급하는 프로세스를 구축합니다.

2. 앱 개발사: 웹 상점에서 앱 사용자가 계정별 구매 제한 및 구매 수량 제한 상품을 구매한 경우, 상품 지급 전 웹 상점 결제 정보 검증 API를 호출합니다.

3. Hive 서버: 해당 주문에서 상품의 최대 구매 수량을 초과했는지 검증합니다. 검증 후 결과를 API 응답값으로 개발사 서버에 전송합니다.

4. 앱 개발사: API 응답값을 확인 후 검증 요건(예: 최대 구매 수량을 초과했는지 여부)을 통과했을 때에만 상품을 지급합니다. 만약 최대 구매 수량을 초과한 구매 주문이라면 상품을 지급하지 않고 결제 취소 처리합니다. 웹 상점은 검증 결과에 문제가 없을때에만 판매 완료한 수량으로 반영 후 상품의 잔여 수량을 감소시킵니다. API 응답값을 확인했을 때 유효하지 않은 결제로 나타난 경우, 개발사 서버에서는 상품을 사용자에게 지급하지 말고 결제 취소 처리를 해야 합니다.

웹 상점 결제 정보 검증 API¶

웹 PG 결제를 완료한 결제 정보를 기준으로 상품의 최대 구매 수량 초과 여부 등 결제가 유효한지 검증합니다.

Request information¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY

Request body¶

Request body sample¶

{
    "type": "paid",
    "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
    "order_id" : "H3175513391360875943",
    "server_id" : "1",
    "appid" : "com.com2us.hivesdk.windows.hivepc", 
    "cs_code" : "20000023100", 
    "paid_datetime": "2025-08-14 10:12:18",
    "quantity": "10",
    "iap_payload": "{\"cs_code\":20000023100,\"data\":{\"server_id\":\"1\",\"server_name\":\"Server 1\",\"channels\":{\"channel_id\":\"11\",\"channel_name\":\"Channel 11\",\"characters\":{\"character_id\":\"111\",\"character_name\":\"Character 111\"}}}}",
}

Response body¶

• 100, 101 응답에만 상품을 정상 지급해야 합니다.
• 3001 응답은 이미 검증 완료된 주문 건입니다. 기존에 상품이 지급되지 않았던 경우에만 지급해야 합니다.
• 3002 응답은 상품의 최대 구매 수량이 초과한 경우입니다. 반드시 해당 주문을 결제 취소해야 합니다. 자세한 사항은 지급 결과 처리를 참고하세요.

Response body sample¶

{
    "code": 100,
    "msg": "success"
}

Response codes¶

다음은 응답 코드(code)에 대한 명세입니다.