구독을 만드는 전용 API 는 없어요
POST /v1/order_subscriptions 같은 생성 엔드포인트를 찾고 계셨다면, 그건 없어요.
구독 계약은 체크아웃에서 구독 상품을 결제할 때 자동으로 만들어져요.
만들어지는 흐름
- 구독 상품을 등록해요 — 상품 생성에서 구독 설정(주기·회차 가격표)을 붙여요.
- 체크아웃으로 주문서를 만들어요 — 체크아웃 생성에 그 상품을 담아요.
- 고객이 결제하면 계약이 생겨요 — 주문과 함께 구독 계약(
order_subscription)이 만들어져요. - 승인이 필요하면 대기해요 — 자동 승인이 아니면 신규 승인으로 대기 계약을 활성화해요.
만들어진 뒤에 할 일
| 하려는 것 | 문서 |
|---|---|
| 계약이 잘 생겼는지 확인 | 계약 조회 · 계약 상세 |
| 대기 계약 승인·거절 | 신규 승인 · 구독 거절 |
| 고객 요청(해지·정지·승계·인수) 승인·거절 | 신청 관리 |
| 회차가 언제 청구되는지 | 회차 관리 |
| 주기·금액을 바꿔야 할 때 | 계약 내용 변경 |
유형부터 정하고 오세요
정기구독·정기배송·종량제·렌탈리스 중 무엇으로 만들지는 유형 선택 가이드에서 정해요. 유형에 따라 상품 설정이 달라져요.