active, trialing, past_due 등), 현재 기간, 대기 중인 취소, 사용자 지정 메타데이터, 그리고 상품에 라이선스가 포함된 경우 소프트웨어 라이선스 키를 추적합니다.
Memberships API를 사용하여 계정의 멤버십 또는 본인의 멤버십 목록을 조회하고, ID나 라이선스 키로 단일 멤버십을 조회하고, 무료 베리언트를 통해 수신자를 초대하고, 수명 주기를 관리할 수 있습니다: 즉시 또는 기간 종료 시 취소, 예약된 취소 되돌리기, 결제 수금 일시 중지 및 재개, 접근 권한 연장 또는 재활성화, 프로모션 코드 또는 제휴자 적용, 갱신 주기 변경, 접근 권한 재동기화, 이전 링크 생성, 메타데이터 업데이트가 가능합니다.
Legacy Memberships 리소스를 대체합니다. 기존 Legacy 통합은 계속 작동합니다. 안정성 보장에 대해서는 API 버전을 참조하세요.
엔드포인트
속성
멤버십의 제휴 수수료입니다. 제휴자가 없거나, 계정에
affiliate:basic:read 권한이 없는 경우 null이며, 웹훅에서는 항상 null입니다.속성
속성
멤버십 통화로 된 정액 수수료이며, 비율 수수료인 경우
null입니다.속성
속성
수수료율이 설정된 방식: 이 제휴자에 대해 설정된 요율은
custom, 플랜 또는 상품의 멤버 제휴 요율은 member, 상품의 글로벌 제휴 요율은 global, Whop 마켓플레이스 추천은 marketplace입니다.사용 가능한 옵션: custom, member, marketplace, global멤버가 취소 사유로 선택한 카테고리입니다. 카테고리를 선택하지 않은 경우
null입니다.사용 가능한 옵션: too_expensive, switching, missing_features, technical_issues, bad_experience, unused, other, testing취소가 요청된 시점, 또는 요청 시간이 기록되지 않은 경우 멤버십이 취소된 시점으로, ISO 8601 타임스탬프입니다. 둘 다 기록되지 않은 경우
null입니다.갱신 금액이 수금되는 방식입니다.
charge_automatically는 매 기간 저장된 결제 수단으로 청구하고, send_invoice는 매 기간 구매자에게 인보이스를 이메일로 보냅니다. 설정되지 않은 경우 null입니다.사용 가능한 옵션: charge_automatically, send_invoice현재 결제 기간이 갱신되는 시점, 또는 갱신되지 않는 멤버십이 만료되는 시점으로, ISO 8601 타임스탬프입니다. 만료가 없는 일회성 구매의 경우
null입니다.Discord, Telegram 등 외부 플랫폼에 있는 멤버의 계정입니다. 연결된 계정이 없으면 비어 있습니다. 웹훅에서는
null입니다.베리언트 통화로 된 베리언트의 현재 선불 가격입니다. 정가이며, 반드시 구매자가 지불한 금액은 아닙니다. 첫 청구가 무료인 경우
amount는 "0.00"입니다.속성
속성
구매자가 로그인하여 결제를 관리할 수 있는 URL입니다. 멤버 레코드가 없거나, 호출자가 구매자가 아니고 계정에 대한
member:manage 권한도 없는 경우 null입니다.계정에서 호출자의 멤버 행입니다. 멤버십이 호출자에게 속한 경우에만 존재하며, 판매자 측 읽기에서는
null입니다.멤버십의 최신 수명 주기 이벤트로,
renewing_on 또는 canceled_on 등이 있습니다. most_recent_action_at과 함께 사용하세요. 기록된 것이 없는 경우 null입니다.사용 가능한 옵션: canceled_on, finished_split_pay_at, canceling_on, ending_on, renewing_on, past_due, next_payment_attempt, paused_at, trial_ends_at, unresolved_at, trial_canceling_onmost_recent_action이 발생했거나 발생할 예정인 시점으로, ISO 8601 타임스탬프입니다. renewing_on처럼 예정된 이벤트의 경우 미래 시간입니다. 기록된 작업이 없는 경우 null입니다.이 멤버십에 기록된 구매자의 전화번호이며, 없으면
null입니다. 판매자의 전화번호 수집이 켜져 있는 경우 체크아웃 시 수집(또는 인증)된 번호이며, 없으면 구매자가 이 판매자와 공유한 계정 번호로 대체됩니다.이 멤버십을 할인하는 프로모션 코드로, 접두사는
promo_입니다. 적용된 것이 없는 경우 null입니다. 체크아웃 시 또는 Apply Promo Code to Membership으로 설정됩니다.아직 적용 중인 프로모션 코드를 반영한, 베리언트 통화로 된 베리언트의 갱신 가격입니다. 구매자의 현지 통화로 청구되는 멤버십은 각 청구일의 환율로 환산된 이 가격이 청구됩니다. 갱신되지 않는 멤버십의 경우
null입니다.속성
속성
멤버십의 결제 상태입니다.
active/trialing 멤버십은 접근 권한을 부여하고, past_due는 결제 실패 후 유예 기간이며, completed 일회성 구매는 접근 권한을 유지하고, canceled/expired는 접근 권한이 없습니다.사용 가능한 옵션: trialing, active, past_due, completed, canceled, expired, unresolvedMembership

