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

Authorizations

​
Secret-Token
string
header
required

Path Parameters

​
id
integer<int64>
required

상품 번호

​
priceId
integer<int64>
required

가격 플랜 번호

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

청구 방식 정보