Skip to main content
PUT
/
api
/
v1
/
products
/
{id}
/
prices
/
{priceId}
curl --request PUT \
  --url https://api.steppay.kr/api/v1/products/{id}/prices/{priceId} \
  --header 'Content-Type: application/json' \
  --header 'Secret-Token: <api-key>' \
  --data '
{
  "price": 6000,
  "unit": "개",
  "firstSale": {
    "enabled": true,
    "price": 1000
  },
  "claim": {
    "methodType": "PRE",
    "whenToClaimType": "FIRST_PAYMENT",
    "billingDate": 0,
    "provideStartDay": 0
  },
  "maximumPurchaseQuantity": 0,
  "expiryPaymentCount": 0,
  "setupOption": {
    "id": 1,
    "name": "가입비",
    "type": "INITIALLY",
    "price": 2000
  },
  "isRepresentative": true,
  "type": "ONE_TIME",
  "plan": {
    "name": "단건 가격플랜 이름",
    "description": "단건 가격플랜 설명",
    "detailDescription": "단건 가격플랜 상세설명",
    "isHiddenFromShop": false,
    "adminName": "admin"
  }
}
'
{
  "id": 1,
  "code": "price_AbCdEfGhI",
  "price": 6000,
  "unit": "string",
  "planName": "string",
  "planDescription": "string",
  "type": "ONE_TIME",
  "enabledFirstSalePrice": true,
  "firstSalePrice": 1000,
  "claimMethodType": "PRE",
  "whenToClaimType": "FIRST_PAYMENT",
  "billingDate": 0,
  "maximumPurchaseQuantity": 0,
  "membershipExpirationDate": 0,
  "membershipExpirationDateType": null,
  "setupOption": {
    "id": 1,
    "name": "가입비",
    "type": "INITIALLY",
    "price": 2000,
    "claimMethodType": "PRE"
  },
  "options": [],
  "volumes": [],
  "additionalBilling": null,
  "recurring": null,
  "createdAt": "9999-01-01T00:00:00",
  "modifiedAt": "9999-01-01T00:00:00.000000",
  "plan": {
    "name": "string",
    "description": "string",
    "detailDescription": "string",
    "isHiddenFromShop": false,
    "adminName": "string"
  },
  "firstSale": {
    "enabled": true,
    "price": 1000
  },
  "claim": {
    "methodType": "PRE",
    "whenToClaimType": "FIRST_PAYMENT",
    "billingDate": 0,
    "provideStartDay": 0
  },
  "basicServing": 0,
  "bundlePrices": [],
  "onetimeBundlePrice": 0,
  "order": 4
}

Authorizations

​
Secret-Token
string
header
required

Path Parameters

​
id
integer<int64>
required

상품 번호

​
priceId
integer<int64>
required

가격플랜 번호

Body

application/json

가격플랜 수정 데이터

​
unit
string
required

단위

​
plan
가격 플랜 정보 · object
required

가격 플랜 정보

​
price
number

가격

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
​
expiryPaymentCount
integer<int32>

구독 만료되는 결제 횟수

​
setupOption
기본료 정보 · object

기본료 정보

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

가격플랜 옵션 수정 정보

​
volumes
object[]
deprecated
​
recurring
구독 주기 수정 정보 · object

구독 주기 수정 정보

​
additionalBilling
추가 과금 수정 정보 · object

추가 과금 수정 정보

​
basicServing
integer<int32>

기본 제공량 - 계정/사용량 기반 요금 사용시 (기본값: 0)

​
isRepresentative
boolean

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

​
bundlePrices
string[]

번들 가격 코드 - 번들로 만들 가격 코드를 입력합니다.

번들 가격 코드 - 번들로 만들 가격 코드를 입력합니다.

​
onetimeBundlePrice
number

번들 플랜 설정 - 번들 플랜에 포함된 단건 가격이 설정됩니다.

​
currencyOnetimeBundlePrice
object

통화별 번들 플랜 단건 가격

​
type
enum<string>

가격 플랜 타입 (기본값: ONE_TIME)

Available options:
ONE_TIME,
FLAT,
UNIT_BASED,
USAGE_BASED,
VOLUME_BASED,
BUNDLE
​
isSupportUpDownGrade
boolean

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

청구 방식 정보