조정 항목 추가
구독 회차의 가격을 할인하거나 추가 요금으로 조정하는 API입니다.
설치비, 프로모션 할인, 옵션 비용 등 다양한 사유로 금액을 조정할 수 있습니다.
POST
https://api.bootapi.com/v1/order_subscriptions/:id/adjustments
회차 재생성 안내
이미 생성된 회차에 조정 항목이 추가되면 기존 회차가 삭제 후 재생성됩니다. 고객에게 별도 알림은 발송되지 않습니다.
조정 타입 설명
type: 0 (일회성)
특정 회차에만 적용되는 조정
type: 2 (매회차)
모든 회차에 반복 적용되는 조정
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
조정 항목 추가
구독 계약에 가격 조정 항목을 추가합니다.
요청 필드
필드명
타입
필수
설명
order_subscription_idstring
필수
구독 계약 고유 번호
namestring
필수
조정 항목명 (예: 설치비, 할인)
pricenumber
필수
조정 금액 (양수: 추가, 음수: 할인)
tax_free_pricenumber
면세 금액
typenumber
필수
조정 타입 (0: 일회성, 2: 매회차 적용)
durationnumber
적용 회차 (특정 회차만 적용 시)
3
Server
응답 처리
추가된 조정 항목을 포함한 전체 목록을 확인합니다.
응답 필드
필드명
타입
설명
order_subscription_idstring
구독 계약 ID
order_subscription_adjustmentsarray
전체 조정 항목 목록
order_subscription_adjustments[].order_subscription_adjustment_idstring
조정 항목 고유 ID
order_subscription_adjustments[].namestring
조정 항목명
order_subscription_adjustments[].pricenumber
조정 금액
order_subscription_adjustments[].typenumber
조정 타입
