구독 계약

구독 계약 개요

계약을 만드는 API 는 없어요. 체크아웃이 그 자리예요.

계약(order_subscription)은 구독 한 건의 뿌리예요. 주기·금액·회차 규칙이 여기 붙고, 회차 청구와 상태 변경은 전부 이 계약을 기준으로 돌아요.

계약을 만드는 전용 API 는 없어요

POST /v1/order_subscriptions 같은 생성 엔드포인트를 찾고 있다면, 그건 없어요. 계약은 고객이 체크아웃에서 구독 상품을 결제할 때 자동으로 만들어져요. 자세한 경로는 구독 만들기를 봐요.

계약이 생기는 경로

  1. 구독 설정이 붙은 상품을 등록해요 — 상품 생성
  2. 그 상품을 담아 주문서를 열어요 — 체크아웃 생성
  3. 고객이 결제하면 주문과 함께 계약이 만들어져요
  4. 자동 승인이 아니면 승인 대기 상태로 서요 — 신규 승인으로 활성화해요

이 메뉴에서 하는 일

하려는 것 문서
계약이 어떻게 만들어지는지 구독 만들기
계약 목록에서 상태·주기·다음 결제일 보기 계약 조회
계약 한 건의 회차와 상태 보기 계약 상세
고객 요청(해지·정지·재개·승계·인수·플랜 변경) 승인·거절 신청 관리
구독을 넘겨받기 인수 요청
구독을 다른 사용자에게 넘기기 승계 요청
해지 전 예상 수수료·환불액 미리 보기 수수료 계산

계약과 운영은 갈라져 있어요

계약이 생긴 뒤의 회차 청구·금액 조정·정지·해지는 구독 운영에서 다뤄요. 경계는 이렇게 나뉘어요.

구독 계약 (여기) 구독 운영
다루는 것 계약이 생기고 주인이 바뀌는 단계 계약이 살아 있는 동안 도는 일
대표 작업 계약 조회, 인수·승계, 고객 요청 승인·거절 계약 승인, 회차 청구, 금액 조정, 정지·재개·해지
기준 시점 계약이 생기고 주인이 바뀔 때 계약 승인 시점부터 종료까지
승인이 두 곳에 있어요 — 같은 말이 아니에요
무엇 어디 뜻
신규 승인 구독 운영 · 신규 승인 계약 자체. 대기 계약을 활성 구독으로 올려요 (PUT /order_subscriptions/:id/approve)
신청 관리 신청 관리 고객이 넣은 요청. 해지·정지·재개·승계·인수·플랜 변경 (/order-subscription-requests)

헷갈리면 구독 용어 사전에서 단계별 용어를 확인해요.

다음 단계

최신 글구독 템플릿 이전 글구독 만들기