Skip to main content
멤버십은 사용자와 상품 간의 활성 관계입니다. 액세스, 청구 상태, 갱신 일정을 추적합니다. 체크아웃이 멤버십을 자동으로 생성하므로 직접 만들 필요는 없습니다. 멤버십이 생성되면 이를 조회하고, 청구를 일시 중지하거나 취소하고, 무료 기간을 제공하거나, 메타데이터를 업데이트할 수 있습니다.
대부분의 앱은 멤버십을 관리할 필요가 전혀 없습니다. 관리자 도구, 고객 지원 흐름, 또는 사용자가 일시 중지하거나 취소할 수 있는 셀프 서비스 대시보드를 구축할 때 이 메서드를 사용하세요.

수명 주기 한눈에 보기

조회 및 목록

일시 중지 및 재개

일시 중지하면 다음 청구 주기가 중지됩니다. 사용자는 현재 기간이 끝날 때까지 기존 액세스를 유지하지만 갱신은 실행되지 않습니다. until을 전달하면 자동 재개를 예약할 수 있습니다.

취소

취소 모드는 두 가지입니다. cancel_at_period_end: true는 현재 갱신일까지 액세스를 유지한 다음 비활성화합니다. 이를 생략하거나 false를 전달하면 즉시 액세스가 취소됩니다.
cancel_at_period_end: true는 멤버십의 cancel_at_period_end를 true로 바꿉니다. 사용자는 갱신 시점까지 액세스를 유지하며, 이후 멤버십이 비활성화되고 이전 상태가 previous_attributes.status에 설정된 membership.updated가 발생합니다. 이 필드를 생략하면 즉시 액세스가 취소되므로, 기간 종료 시 취소하려는 경우에는 항상 명시적으로 보내세요.

취소 복원하기

사용자가 기간이 끝나기 전에 마음을 바꾸면 업데이트로 대기 중인 기간 종료 취소를 해제하세요. 멤버십이 취소 예정이 아니었다면 아무런 영향이 없습니다.

무료 일수 추가하기

사용자의 현재 기간에 추가 시간을 무료로 제공하세요. 다음 갱신일이 days만큼 뒤로 이동합니다. 서비스 중단, 지원 차원의 보상, 추천 보상 등에 유용합니다.
days는 1부터 1095(3년)까지 허용합니다.

메타데이터 업데이트하기

멤버십의 임의 메타데이터 또는 기타 쓰기 가능한 필드를 수정하세요.

수명 주기 이벤트 수신하기

웹훅을 통해 구독하세요. 수명 주기 전반에 걸쳐 발생하는 이벤트는 다음과 같습니다: pause / resume / extend의 경우 멤버십 상태가 바뀌지 않으므로 활성화/비활성화 이벤트가 발생하지 않습니다. 변경이 성공했는지 확인해야 한다면 호출 후 멤버십을 조회하거나 자체 일정에 따라 폴링하세요.

다음 단계

결제 받기

멤버십이 생성되는 곳입니다. 일회성 및 정기 체크아웃.

결제 수단 저장

향후 갱신 및 오프세션 청구를 위해 등록된 카드입니다.

웹훅 수신하기

활성화, 비활성화, 취소 전환에 대응하세요.

멤버십 API 레퍼런스

전체 리소스: 필드, 상태, 모든 엔드포인트.