정기배송(delivery_subscription)은 실물 상품을 정해진 주기로 반복 배송하는 구독 유형입니다. 매 회차 결제가 성공할 때마다 그 회차의 배송 주문이 자동 생성됩니다. 정기구독·렌탈은 1회차(계약 시점)에만 배송 주문을 만듭니다. 유형 구분은 유형 선택 가이드를 참고합니다.
전체 흐름
시작 순서
배송 정책 설계
배송 주기, 결제 후 며칠 뒤 배송할지, 배송불가 요일을 정합니다. 배송 정책 설정
상품 등록
실물(배송) 상품에 정기배송 템플릿을 적용합니다.
신청 → 승인
고객이 배송지를 입력해 신청하면 신규 승인으로 첫 결제와 첫 배송 주문을 만듭니다.
회차 배송 운영
매 회차 생성되는 배송 주문을 출고 처리합니다. 회차 배송 흐름
공통 API 바로가기
| 하고 싶은 것 | 문서 |
|---|---|
| 계약 목록·상태 조회 | 계약 조회 |
| 회차·결제 내역 확인 | 회차 조회 · 거래 목록 |
| 이번 회차 금액 보정 | 회차 금액 조정 |
| 일시정지·재개·해지 | 일시정지 · 재개 · 해지 |
| 회차 배송 주문 조회 | 주문 조회 |
배송 정책 설정
정기배송의 배송 규칙은 구독 템플릿에서 정합니다. 여기서 정한 정책이 상품에 적용되고, 계약 시점에 스냅샷으로 고정됩니다.
설정 항목
| 설정 | 설명 |
|---|---|
| 배송 주기 | 회차가 반복되는 간격입니다. 결제 주기와 함께 굴러갑니다. |
| 배송 소요일 | 결제 성공 후 며칠 뒤 배송 예정일로 잡을지 정합니다. 도서·산간 지역은 추가 소요일이 반영됩니다. |
| 배송불가 요일 | 물류가 쉬는 요일을 지정하면, 배송 예정일이 그 요일에 걸릴 때 자동으로 다음 가능한 날로 미뤄집니다. |
| 배송지 변경 허용 | 구독 중 고객이 배송지를 바꿀 수 있게 할지 정합니다. |
| 배송일 변경 허용 | 고객이 이번 회차 배송을 미루거나(딜레이) 당길 수(긴급) 있게 할지 정합니다. |
배송 예정일 = 회차 결제일 + 배송 소요일. 이 날짜가 배송불가 요일이면 다음 가능 요일로 롤오버됩니다. 계산은 부트페이가 자동으로 처리합니다.
관련 문서
- 회차 배송 흐름 — 설정이 실제 회차에서 동작하는 방식
- 배송지·배송일 변경 — 운영 중 변경 처리
- 구독 모델 구조 — 템플릿·정책·스냅샷 관계
회차 배송 흐름
정기배송에서 회차는 결제 단위이자 배송 단위입니다. 회차 하나가 성공하면 그 회차의 배송 주문이 하나 생깁니다.
회차마다 일어나는 일
회차 결제일 도달
부트페이가 빌링키로 자동 결제를 시도합니다.
결제 성공 → 배송 주문 생성
그 회차의 배송 주문이 자동으로 만들어집니다. 배송 예정일은 배송 정책의 소요일·배송불가 요일 규칙으로 계산됩니다.
가맹점 출고
생성된 주문을 주문 API로 조회하고 출고·송장 처리를 합니다.
다음 회차 예약
다음 결제일과 다음 배송 예정일이 자동으로 예약됩니다.
결제 실패 시
회차 결제가 실패하면 배송 주문은 생성되지 않습니다. 부트페이가 재시도 스케줄을 실행하고, 재시도로 성공하면 그 시점 기준으로 배송 예정일이 계산됩니다. 재시도 정책은 구독 흐름 설계를 참고합니다.
결제 성공 회차만 출고 대상입니다. 회차 상태는 회차 조회로 동기화합니다.
다른 유형과의 차이
| 정기배송 | 정기구독·렌탈·종량제 | |
|---|---|---|
| 배송 주문 생성 | 매 회차 | 배송 상품이면 1회차만 |
| 결제 실패의 의미 | 이번 회차 출고 보류 | 서비스 이용 유예/차단 |
관련 문서
배송지·배송일 변경
변경 가능 여부는 배송 정책 설정에서 템플릿에 미리 정해둔 허용 범위를 따릅니다.
변경 경로
| 누가 | 방법 |
|---|---|
| 고객 | 부트페이가 호스팅하는 마이페이지에서 배송지·배송일을 직접 변경합니다. 템플릿에서 허용한 항목만 노출됩니다. |
| 관리자 | CS로 접수된 배송지 변경은 계약 내용 변경의 address_id 로 계약 정보를 직접 수정합니다. 배송일은 이 API로 바꿀 수 없습니다. |
배송일 변경 두 방향
| 동작 | 언제 |
|---|---|
| 미루기 (딜레이) | 재고가 남았거나 장기 부재일 때 이번 회차 배송을 뒤로 미룹니다. |
| 당기기 (긴급) | 상품이 일찍 떨어졌을 때 이번 회차 배송을 앞당깁니다. |
두 동작 모두 템플릿에서 각각 허용을 켜야 고객에게 노출됩니다.
장기 중단
배송일 미루기로 감당이 안 되는 장기 중단(장기 출장, 계절 상품)은 일시정지 → 재개 흐름으로 처리합니다. 일시정지 중에는 결제와 배송이 모두 멈춥니다.
관련 문서
제약과 주의점
배송비 쿠폰 적용 불가
정기배송 구독에는 배송비 쿠폰을 적용할 수 없습니다. 적용을 시도하면 에러가 반환됩니다.
| 에러 코드 | 의미 |
|---|---|
11513 |
정기배송 구독에는 배송비 쿠폰을 적용할 수 없습니다 |
상품 금액 할인 쿠폰은 정상 적용됩니다. 회차 단위 할인이 필요하면 회차 금액 조정을 씁니다.
해지·환불 기준
정기배송의 해지 처리 기준입니다.
| 시점 | 처리 |
|---|---|
| 출고 전 | 이번 회차 취소 후 해지 가능 |
| 출고 후 | 이번 회차는 반품 절차, 다음 회차부터 해지 |
해지 요청 API는 유형 공통입니다. 해지를 참고합니다.
관련 문서
- 유형 선택 가이드 — 유형 구분
- 구독 상품 유형별 차이 — 정기배송 운영 정책 (블로그)



