구독 및 청구
고객의 요금제를 판매, 변경 및 종료하고 카드 청구 내역을 확인하세요.
각 고객 워크스페이스는 판매하는 티어 중 하나를 구독할 수 있습니다. 리셀러 카드로 모든 워크스페이스의 인보이스를 결제합니다. 워크스페이스의 현재 구독은 has_payment_issue와 함께 workspaces.list의 subscription 필드에 표시됩니다.
요금제 할당
아직 요금제가 없는 워크스페이스를 구독시킵니다. billing_period는 monthly_period(기본값) 또는 annual_period입니다.
모든 할당 또는 변경 시 생성한 idempotency_key를 전송하세요. 요청 시간이 초과되더라도 동일한 키로 재시도하면 워크스페이스를 두 번 구독시키거나 청구할 수 없습니다.
has_payment_issue가 true인 동안에는 요금제를 할당하거나 변경할 수 없습니다. 재시도하기 전에 고객에게 미결제 인보이스를 보여 주거나 해당 pay_url을 통해 결제하세요.
요금제 변경
subscriptions.change는 assign와 동일한 본문을 사용합니다.
- 업그레이드는 즉시 적용됩니다.
- 다운그레이드 또는 같은 수준의 티어로의 이동은 청구 기간이 끝날 때 적용됩니다. 그때까지 구독에는 새 티어가
pending_downgrade_tier에, 적용 날짜가pending_downgrade_at_unix에 표시됩니다.
워크스페이스를 현재 티어로 유지하려면 subscriptions.cancel_pending_downgrade로 예약된 다운그레이드를 취소하세요.
다운그레이드가 적용되면 새 요금제의 한도를 초과하는 리셉셔니스트와 전화번호는 비활성화되고, 팀 규모를 초과하는 팀 구성원은 일시 중단됩니다.
요금제 종료
subscriptions.unassign는 현재 청구 기간이 끝날 때 구독을 종료합니다. 그때까지 cancel_at_unix에 종료 시점이 표시되며, subscriptions.restore를 사용하면 취소를 되돌려 요금제가 정상적으로 갱신됩니다.
인보이스
카드 청구 건마다 하나의 워크스페이스 인보이스가 결제됩니다. billing.list_invoices는 최신순으로 한 번에 한 페이지씩 반환합니다. 인보이스의 status는 다음 중 하나입니다.
billing.get_invoice는 인보이스의 lines를 추가로 반환합니다. amount_cents가 음수인 항목은 일할 계산 크레딧이며, 항목의 합계는 항상 청구 금액과 일치합니다.
예정 결제
billing.list_upcoming_payments는 각 워크스페이스의 다음 갱신 결제를 가장 빠른 순서로 추정합니다. plan_usd는 갱신 시 선불로 청구되는 요금제이며, 다운그레이드가 예약된 경우 다운그레이드될 티어의 가격입니다. overage_so_far_usd는 현재 기간에 포함된 통화 시간을 초과한 지금까지의 사용량입니다. 갱신 시 청구되며, 그때까지 계속 증가합니다.