이럴 때 선택해요: 식품·화장품·생활용품·굿즈 박스처럼 실물 상품을 정해진 주기로 반복 배송하는 서비스
enum 값:delivery_subscription— 유형 선택 가이드
정기배송은 결제와 물류가 연결된 구독 유형이에요. 다른 유형과의 결정적 차이는 하나예요 — 매 회차 결제가 성공할 때마다 그 회차의 배송 주문이 자동 생성돼요. 정기구독·렌탈이 1회차(계약 시점)에만 배송을 만드는 것과 다르게, 정기배송은 회차마다 출고가 반복돼요.
내가 하는 것
- 배송 주기·배송 정책 설계
- 회차 배송 주문의 출고·물류 처리
- 배송지 변경 허용 범위 결정
- 재고·출고 마감 운영
Bootpay가 알아서 하는 것
- 매 회차 자동 결제, 실패 재시도
- 결제 성공 시 회차 배송 주문 생성
- 배송 예정일 계산 (배송불가 요일 자동 회피)
- 웹훅 알림, 회차·주문 내역 제공
전체 흐름
결제일이 사실상 배송 마감일이에요. 결제 직전 배송지 변경 마감, 이번 회차 건너뛰기, 출고 후 취소 불가 시점을 정책으로 먼저 정해야 CS가 줄어요.
시작 순서
배송 정책 설계
배송 주기, 결제 후 며칠 뒤 배송할지, 배송불가 요일을 정해요. 배송 정책 설정
상품 등록
실물(배송) 상품에 정기배송 템플릿을 적용해요.
신청 → 승인
고객이 배송지를 입력해 신청하면 신규 승인으로 첫 결제와 첫 배송 주문을 만들어요.
회차 배송 운영
매 회차 생성되는 배송 주문을 출고 처리해요. 회차 배송 흐름
공통 API 바로가기
| 하고 싶은 것 | 문서 |
|---|---|
| 계약 목록·상태 조회 | 계약 조회 |
| 회차·결제 내역 확인 | 회차 조회 · 거래 목록 |
| 이번 회차 금액 보정 | 금액 조정 |
| 일시정지·재개·해지 | 일시정지 · 재개 · 해지 |
| 회차 배송 주문 조회 | 주문 조회 |