Skip to content
스토어 연동
마지막 업데이트

게임 쿠폰 등록 API

소개

게임 쿠폰을 등록합니다

기본정보

text
POST /coupon/v3.0/{user_token_type}/game/coupon/use
Host:
   https://api.onstove.com (LIVE)    
   https://api.gate8.com (SB)
Content-Type: application/json

Request

NameTypeRequiredDefault ValueExampleDescription
AuthorizationStringY-사용자의 인증을 통해 발급 되는 access token

Path Variable

NameTypeRequiredDefault ValueExampleDescription
user_token_typestringY-web유저토큰종류 공통 - 모든 타입의 토큰 사용

Parameter

NameTypeRequiredDefault ValueExampleDescription
game_codestringY-STOVE_QA_ALPHA게임ID (플랫폼에서 부여)
coupon_nostringY-H370Y300R2M02YV0쿠폰박스 일련번호
client_ipaddrStringY-10.5.24.52회원 접속 아이피
world_noStringN-1게임 월드 번호
character_noStringN-52345642회원 캐릭 번호
game_coupon_idInt64N-15451게임쿠폰아이디 (있는 경우, 해당 게임쿠폰아이디 값과 맞지 않으면 잘못된 쿠폰번호로 처리)
lang_codeStringY-ko언어코드

Response

Body

NameTypeRequiredDefault ValueExampleDescription
resultStringY-000응답 코드
messageStringY-OK응답 메시지
valueObjectN--응답 값

value

NameTypeRequiredDefault ValueExampleDescription
coupon_box_idInt64Y-6449393쿠폰박스 일련번호
cbox_save_flagBooleanY-ture쿠폰함 저장 여부

Sample

Request

text
curl --location --request POST '/coupon/v3.0/web/game/coupon/use' \
--header 'Authorization: Bearer {{access_token}}'
{         
    "game_code":"STOVE_QA_ALPHA",
    "coupon_no":"AMH0G4E0A110VBM8",
    "client_ipaddr":"211.34.57.2",
    "world_no":"1",
    "character_no":"98175593",
    "lang_code":"ko"    
}

Response

text
{
    "value":
    {
        "coupon_box_id":4010326,
        "cbox_save_flag":false
    },
    "result": "000",
    "message": "OK"
}

응답 실패 예제

text
{
    "result": "5105",
    "message": "잘못된 쿠폰 번호입니다. 쿠폰 번호를 확인해주시기 바랍니다. (1회 실패)"
}

Return Code

HTTP Status codeCodeMessageDescription
2005031일일 인증 횟수를 초과하였습니다.
2005105잘못된 쿠폰 번호입니다. 쿠폰 번호를 확인해주시기 바랍니다.잘못된 쿠폰 번호입니다. ({0}회 실패) 쿠폰 번호를 확인해주시기 바랍니다. - 실제 나가는 에러 메세지
2005165쿠폰함에서만 사용 가능한 쿠폰 입니다.해당 쿠폰 번호가 계정지급쿠폰의 쿠폰번호 인 경우
2005450이미 쿠폰함에 등록된 쿠폰입니다.쿠폰번호를 최대 1번 사용 가능하고 이미 쿠폰함에 등록되어 있는 쿠폰번호 인 경우
2005125이미 사용한 쿠폰입니다.
2005130사용 중지된 쿠폰입니다.파트너스나 게임이용동의 해지로 폐기된 쿠폰인 경우
2005135유효기간이 만료된 쿠폰입니다.쿠폰사용기간이 지남
2005161등록 기간이 만료된 쿠폰입니다.쿠폰등록기간이 지남
2006055등록기간이 아닙니다.(등록기간이 되지 않았음)
2005162해당 국가에서 사용할 수 없는 쿠폰입니다.
2002605해당 멤버쉽 계정은 사용할 수 없습니다.
2005202이미 해당 그룹 쿠폰을 사용하셨습니다.그룹쿠폰
2005033해당 쿠폰번호를 더 이상 사용하실 수 없습니다.하나의 쿠폰키로 여러번 사용가능한 경우(대표쿠폰,그룹쿠폰 해당됨)
2005155해당 쿠폰의 사용가능 횟수를 초과 하였습니다.
2005200해당 쿠폰에 대한 사용 대상이 아닙니다.대상지정쿠폰-해당 계정이 아닌 경우
2006033해당 그룹의 쿠폰을 이미 사용하였습니다.쿠폰 그룹핑 그룹핑된 다른 쿠폰을 사용한 경우
2006026사용 횟수가 초과 되었습니다.24시간 제한
200100PC방에서만 사용 가능한 쿠폰입니다.이전메세지(PC방 전용 쿠폰.)
2007014캐릭터를 선택해 주세요.등록 즉시 사용 쿠폰이면서, 캐릭터정보가 필요한 경우
2005164해당 월드에서는 사용할 수 없는 쿠폰입니다.
200그 외Internal Error내부오류: *STOVE 기술PM팀으로 문의 바랍니다.
401999Authorization has been denied for this request

문의사항


문의사항이 있다면 디스코드 또는나 store.support@smilegate.com로 문의해 주세요.