Skip to main content
POST

Authorizations

Secret-Token
string
header
required

Path Parameters

id
integer<int64>
required

상품 번호

Body

application/json

가격플랜 생성 데이터

unit
string
required

단위

plan
가격 플랜 정보 · object
required

가격 플랜 정보

type
enum<string>
required

가격 플랜 타입

Available options:
ONE_TIME,
FLAT,
UNIT_BASED,
USAGE_BASED,
VOLUME_BASED,
BUNDLE
price
number

기본 가격 (기본값: 0)

Required range: x > 0
currencyPrice
object

통화별 기본 가격

firstSale
첫 구매 할인 정보 · object

첫 구매 할인 정보

claim
청구 방식 정보 · object

청구 방식 정보

maximumPurchaseQuantity
integer<int32>

최대 구매 가능 개수 지정

membershipExpirationDate
integer<int32>
deprecated

구독 만기 기간

membershipExpirationDateType
enum<string>
deprecated

구독 만기 기간 단위

Available options:
DAY,
WEEK,
MONTH,
YEAR
expiryRecurringCount
integer<int32>

구독 만료되는 결제 횟수

setupOption
기본료 정보 · object

기본료 정보

options
object[]
deprecated

추가 구매 가능한 상품 옵션

recurring
object

반복 주기, 가격 타입이 ONE_TIME이 아닌 경우 필수값입니다.

basicServing
integer<int32>

기본 제공량 - 계정/사용량 기반 요금 사용시

isRepresentative
boolean

대표 가격 지정 - 스텝샵에서 기본 가격으로 설정됩니다. (기본값: false)

onetimeBundlePrice
number

번들 플랜 설정 - 번들 플랜의 단건 가격을 설정합니다.

currencyOnetimeBundlePrice
object

통화별 번들 플랜 단건 가격

Response

정상적으로 생성됨

가격 플랜 정보

id
integer<int64>
required

가격 플랜 아이디

code
string
required

가격 플랜 코드

price
number
required

가격(기준통화)

type
enum<string>
required

플랜 타입

Available options:
ONE_TIME,
FLAT,
UNIT_BASED,
USAGE_BASED,
VOLUME_BASED,
BUNDLE
enabledFirstSalePrice
boolean
required
deprecated

첫 구매 할인 적용 여부

firstSalePrice
number
required
deprecated

첫 구매 할인시 적용되는 할인 금액

billingDate
integer<int32>
required

후불일 때 결제되는 날짜를 지정한 경우, 지정된 날짜

maximumPurchaseQuantity
integer<int32>
required

최대 구매가능 수량

membershipExpirationDate
integer<int32>
required

구독 만기 기간

options
가격 플랜 옵션 정보 · object[]
required
deprecated

옵션 정보

volumes
object[]
required
deprecated
basicServing
integer<int32>
required

기본 제공량 - 계정/사용량 기반 요금 사용시

bundlePrices
object[]
required

번들 플랜 - 번들 상품 구성

onetimeBundlePrice
number
required

번들 플랜 - 단건 상품 금액

order
integer<int32>
required

우선 순위

currencyPrice
object

통화별 가격(기준통화 외)

unit
string

단위

planName
string
deprecated

플랜명

planDescription
string
deprecated

플랜 설명

claimMethodType
enum<string>

선불인지 후불인지 여부

Available options:
PRE,
POST
whenToClaimType
enum<string>

후불인 경우, 언제 결제되는지

Available options:
FIRST_PAYMENT,
DATE
membershipExpirationDateType
enum<string>

구독 만기 기간 단위

Available options:
DAY,
WEEK,
MONTH,
YEAR
setupOption
기본료 정보 · object

기본료 정보

additionalBilling
추가 과금 정보 · object

추가 과금 정보

recurring
구독 주기 정보 · object

구독 주기 정보

createdAt
string<date-time>

생성된 시점

modifiedAt
string<date-time>

수정된 시점

plan
가격 플랜 정보 · object

가격 플랜 정보

firstSale
첫 구매 할인 정보 · object

첫 구매 할인 정보

claim
청구 방식 정보 · object

청구 방식 정보