쿠폰 관리

뒤끝 콘솔에 등록한 쿠폰의 리스트를 받아오고, 사용하는 기능을 제공합니다.

쿠폰 리스트 받아오기

뒤끝 콘솔에 등록한 쿠폰의 리스트를 가져옵니다.

동기

CouponList ( ) -> BackendReturnObject

// example
Backend.Coupon.CouponList ();

비동기

CouponList ( Function callback ) -> void

// example
Backend.Coupon.CouponList ( ( callback ) => {
    // 이후 처리
});

결과값 예시

{ 
    rows: 
    [ 
        { 
            // 쿠폰 uuid
            uuid: { S: "c2054080-d75b-11e8-8857-994ebc4f2e58" },
            // 쿠폰 명
            title: { S: "회원가입 감사쿠폰" },
            // 쿠폰 타입 (serial/single):시리얼/단일
            type: { S: "serial" },
            // version 정보 (y: version1 , n: version2)
            old:{ S: "y"}
        },
        { 
            uuid: [Object], 
            title: [Object], 
            type: [Object],
            old: [Object]
        }
    ]
}

쿠폰 사용하기

쿠폰 사용에 성공하면 사용한 쿠폰의 종류를 {"uuid":"5f8dc8c0-fa73-11e7-83b3-db17cb8aa0a6"}와 같은 형식으로 리턴합니다.
자동생성된 쿠폰의 old 버전 쿠폰코드는 16자, new 버전 쿠폰코드는 18자 입니다.

동기

UseCoupon ( String couponCode ) -> BackendReturnObject

// example
Backend.Coupon.UseCoupon ( "18c7c2e1d16e779b" );

비동기

UseCoupon ( String couponCode , Function callback ) -> void

// example
Backend.Coupon.UseCoupon ( "18c7c2e1d16e779b", ( callback ) => {
    // 이후 처리
});

Parameter

ValueTypeDescription
couponCodeString뒤끝 콘솔에서 발급된 쿠폰 코드

Error cases

  • Old Version 사용 시

    • 기간 만료된 쿠폰의 경우
      statusCode : 410
      errorCode : GoneResourceException
      message : Gone expired coupon, 사라진 expired coupon 입니다

    • 단일쿠폰의 회수율이 100%인 경우
      statusCode : 404
      errorCode : NotFoundException
      message : coupon not found, coupon을(를) 찾을 수 없습니다

    • 한 명의 게이머가 단일쿠폰을 두 번 이상 사용 시도한 경우
      statusCode : 409
      errorCode : ConflictErrorParameterException
      message : ConflictError use coupon, 충돌된 use coupon 입니다

    • 이미 사용한 시리얼쿠폰을 다시 사용한 경우
      statusCode : 404
      errorCode : NotFoundException
      message : coupon not found, coupon을(를) 찾을 수 없습니다

  • New Version 사용 시

    • 시리얼 쿠폰 중복사용
      statusCode : 404
      errorCode : NotFoundException
      message : 이미 사용되었거나, 틀린 번호입니다. not found, 이미 사용되었거나, 틀린 번호입니다.을(를) 찾을 수 없습니다

    • 단일쿠폰의 회수율이 100%인 경우, 기간 만료된 쿠폰의 경우
      statusCode : 404
      errorCode : NotFoundException
      message : 전부 사용 된 쿠폰입니다. not found, 전부 사용 된 쿠폰입니다.을(를) 찾을 수 없습니다

    • 한 명의 게이머가 단일쿠폰을 두 번 이상 사용 시도한 경우
      statusCode : 404
      errorCode : NotFoundException
      message : 이미 사용하신 쿠폰입니다. not found, 이미 사용하신 쿠폰입니다.을(를) 찾을 수 없습니다