조정 항목 추가
구독 회차의 가격을 할인하거나 추가 요금으로 조정하는 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_id | string | 필수 | 구독 계약 고유 번호 |
name | string | 필수 | 조정 항목명 (예: 설치비, 할인) |
price | number | 필수 | 조정 금액 (양수: 추가, 음수: 할인) |
tax_free_price | number | 면세 금액 | |
type | number | 필수 | 조정 타입 (0: 일회성, 2: 매회차 적용) |
duration | number | 적용 회차 (특정 회차만 적용 시) |
3
Server
응답 처리
추가된 조정 항목을 포함한 전체 목록을 확인합니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
order_subscription_id | string | 구독 계약 ID |
order_subscription_adjustments | array | 전체 조정 항목 목록 |
order_subscription_adjustments[].order_subscription_adjustment_id | string | 조정 항목 고유 ID |
order_subscription_adjustments[].name | string | 조정 항목명 |
order_subscription_adjustments[].price | number | 조정 금액 |
order_subscription_adjustments[].type | number | 조정 타입 |
