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
}가격플랜 수정
가격플랜을 수정할 때 호출합니다. 파라미터로 전달된 정보로 가격플랜 정보가 치환됩니다. 연관 주문이 존재한다면 이름과 설명만 수정됩니다.
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
Body
가격플랜 수정 데이터
단위
가격 플랜 정보
Show child attributes
Show child attributes
가격
x > 0통화별 가격
Show child attributes
Show child attributes
첫 구매 할인 정보
Show child attributes
Show child attributes
청구 방식 정보
Show child attributes
Show child attributes
최대 구매 수량
구독 만기 기간
구독 만기 기간 단위
DAY, WEEK, MONTH, YEAR 구독 만료되는 결제 횟수
기본료 정보
Show child attributes
Show child attributes
가격플랜 옵션 수정 정보
Show child attributes
Show child attributes
Show child attributes
Show child attributes
구독 주기 수정 정보
Show child attributes
Show child attributes
추가 과금 수정 정보
Show child attributes
Show child attributes
기본 제공량 - 계정/사용량 기반 요금 사용시 (기본값: 0)
대표 가격 지정 - 스텝샵에서 기본 가격으로 설정됩니다. (기본값: false)
번들 가격 코드 - 번들로 만들 가격 코드를 입력합니다.
번들 가격 코드 - 번들로 만들 가격 코드를 입력합니다.
번들 플랜 설정 - 번들 플랜에 포함된 단건 가격이 설정됩니다.
통화별 번들 플랜 단건 가격
Show child attributes
Show child attributes
가격 플랜 타입 (기본값: ONE_TIME)
ONE_TIME, FLAT, UNIT_BASED, USAGE_BASED, VOLUME_BASED, BUNDLE Response
정상적으로 수정됨
가격 플랜 정보
가격 플랜 아이디
가격 플랜 코드
가격(기준통화)
플랜 타입
ONE_TIME, FLAT, UNIT_BASED, USAGE_BASED, VOLUME_BASED, BUNDLE 첫 구매 할인 적용 여부
첫 구매 할인시 적용되는 할인 금액
후불일 때 결제되는 날짜를 지정한 경우, 지정된 날짜
최대 구매가능 수량
구독 만기 기간
옵션 정보
Show child attributes
Show child attributes
Show child attributes
Show child attributes
기본 제공량 - 계정/사용량 기반 요금 사용시
번들 플랜 - 번들 상품 구성
Show child attributes
Show child attributes
번들 플랜 - 단건 상품 금액
우선 순위
통화별 가격(기준통화 외)
Show child attributes
Show child attributes
단위
플랜명
플랜 설명
선불인지 후불인지 여부
PRE, POST 후불인 경우, 언제 결제되는지
FIRST_PAYMENT, DATE 구독 만기 기간 단위
DAY, WEEK, MONTH, YEAR 기본료 정보
Show child attributes
Show child attributes
추가 과금 정보
Show child attributes
Show child attributes
구독 주기 정보
Show child attributes
Show child attributes
생성된 시점
수정된 시점
가격 플랜 정보
Show child attributes
Show child attributes
첫 구매 할인 정보
Show child attributes
Show child attributes
청구 방식 정보
Show child attributes
Show child attributes