할인 API

구독에 붙여 인보이스 금액을 깎는 할인에 관한 API 입니다.

조건에 맞는 구독 할인 리스트를 조회합니다.

구독에 붙여 인보이스 금액을 깎는 할인을 생성합니다.

주어진 아이디로 구독 할인을 조회합니다. 보관된 할인도 조회됩니다.

구독 할인의 이름을 수정합니다. 적용 마감일이 지난 할인도 이름은 바꿀 수 있습니다. 할인 조건과 적용 마감일은 생성 후 바꿀 수 없으므로 바꾸려면 새 할인을 만들어야 합니다.

구독 할인을 보관합니다. 보관된 할인은 새로 붙일 수 없고, 이미 붙은 구독에서는 잔여 회차까지 적용됩니다.

보관된 구독 할인의 보관을 해제해 다시 구독에 붙일 수 있게 합니다.

타입 정의

API 요청/응답의 각 필드에서 사용되는 타입 정의들을 확인할 수 있습니다
ArchiveSubscriptionDiscountError: ForbiddenError | InvalidRequestError | SubscriptionDiscountNotFoundError | ...
ArchiveSubscriptionDiscountResponse: { discount }
구독 할인 보관 성공 응답
CreateSubscriptionDiscountBody: { storeId, id, name, ... }
구독 할인 생성 입력 정보
CreateSubscriptionDiscountResponse: { discount }
구독 할인 생성 성공 응답
Currency: "KRW" | "USD" | "JPY" | ...
통화
ForbiddenError: { type, message }
요청이 거절된 경우
GetSubscriptionDiscountResponse: { discount }
구독 할인 조회 성공 응답
GetSubscriptionDiscountsBody: { storeId, page, archived }
구독 할인 다건 조회 입력 정보
GetSubscriptionDiscountsError: ForbiddenError | InvalidRequestError | UnauthorizedError
GetSubscriptionDiscountsResponse: { items, page }
구독 할인 다건 조회 성공 응답
InvalidRequestError: { type, message }
요청된 입력 정보가 유효하지 않은 경우

허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.

PageInfo: { number, size, totalCount }
반환된 페이지 결과 정보
PageInput: { number, size }
다건 조회 API 에 사용되는 페이지 입력 정보
SubscriptionDiscount: { id, name, type, ... }
구독 할인

얼마를 깎는지만 정합니다. 무엇에 몇 회차 적용할지는 구독에 붙일 때 정합니다.

SubscriptionDiscountAlreadyExistsError: { type, message }
같은 아이디의 구독 할인이 이미 존재하는 경우
SubscriptionDiscountNotFoundError: { type, message }
요청된 구독 할인이 존재하지 않는 경우
SubscriptionDiscountType: "PERCENT" | "AMOUNT"
구독 할인 유형
UnarchiveSubscriptionDiscountError: ForbiddenError | InvalidRequestError | SubscriptionDiscountNotFoundError | ...
UnarchiveSubscriptionDiscountResponse: { discount }
구독 할인 보관 해제 성공 응답
UnauthorizedError: { type, message }
인증 정보가 올바르지 않은 경우
UpdateSubscriptionDiscountBody: { storeId, name }
구독 할인 수정 입력 정보
UpdateSubscriptionDiscountError: ForbiddenError | InvalidRequestError | SubscriptionDiscountNotFoundError | ...
UpdateSubscriptionDiscountResponse: { discount }
구독 할인 수정 성공 응답