탐색으로 건너뛰기

구독 및 청구

고객의 요금제를 판매, 변경 및 종료하고 카드 청구 내역을 확인하세요.

각 고객 워크스페이스는 판매하는 티어 중 하나를 구독할 수 있습니다. 리셀러 카드로 모든 워크스페이스의 인보이스를 결제합니다. 워크스페이스의 현재 구독은 has_payment_issue와 함께 workspaces.list의 subscription 필드에 표시됩니다.

요금제 할당

아직 요금제가 없는 워크스페이스를 구독시킵니다. billing_period는 monthly_period(기본값) 또는 annual_period입니다.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
elevenlabs.reception.subscriptions.assign(
"8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
billing_period="annual_period",
idempotency_key="assign-8f1c2a7e-2026-11-03",
)

모든 할당 또는 변경 시 생성한 idempotency_key를 전송하세요. 요청 시간이 초과되더라도 동일한 키로 재시도하면 워크스페이스를 두 번 구독시키거나 청구할 수 없습니다.

has_payment_issue가 true인 동안에는 요금제를 할당하거나 변경할 수 없습니다. 재시도하기 전에 고객에게 미결제 인보이스를 보여 주거나 해당 pay_url을 통해 결제하세요.

요금제 변경

subscriptions.change는 assign와 동일한 본문을 사용합니다.

  • 업그레이드는 즉시 적용됩니다.
  • 다운그레이드 또는 같은 수준의 티어로의 이동은 청구 기간이 끝날 때 적용됩니다. 그때까지 구독에는 새 티어가 pending_downgrade_tier에, 적용 날짜가 pending_downgrade_at_unix에 표시됩니다.

워크스페이스를 현재 티어로 유지하려면 subscriptions.cancel_pending_downgrade로 예약된 다운그레이드를 취소하세요.

elevenlabs.reception.subscriptions.change(
"8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
tier_id="smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5",
)
elevenlabs.reception.subscriptions.cancel_pending_downgrade("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")

다운그레이드가 적용되면 새 요금제의 한도를 초과하는 리셉셔니스트와 전화번호는 비활성화되고, 팀 규모를 초과하는 팀 구성원은 일시 중단됩니다.

요금제 종료

subscriptions.unassign는 현재 청구 기간이 끝날 때 구독을 종료합니다. 그때까지 cancel_at_unix에 종료 시점이 표시되며, subscriptions.restore를 사용하면 취소를 되돌려 요금제가 정상적으로 갱신됩니다.

elevenlabs.reception.subscriptions.unassign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")
elevenlabs.reception.subscriptions.restore("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")

인보이스

카드 청구 건마다 하나의 워크스페이스 인보이스가 결제됩니다. billing.list_invoices는 최신순으로 한 번에 한 페이지씩 반환합니다. 인보이스의 status는 다음 중 하나입니다.

상태의미
paid카드로 청구되었습니다.
open카드 재시도가 계속 진행 중입니다. pay_url은 결제 페이지로 연결됩니다.
void재시도 횟수가 소진되어 워크스페이스 요금제가 종료되었습니다.

billing.get_invoice는 인보이스의 lines를 추가로 반환합니다. amount_cents가 음수인 항목은 일할 계산 크레딧이며, 항목의 합계는 항상 청구 금액과 일치합니다.

page = elevenlabs.reception.billing.list_invoices(page_size=25)
for invoice in page.invoices:
print(invoice.workspace_name, invoice.status, invoice.amount_cents / 100, invoice.currency)
detail = elevenlabs.reception.billing.get_invoice(page.invoices[0].invoice_id)
for line in detail.lines:
print(line.kind, line.description, line.amount_cents)

예정 결제

billing.list_upcoming_payments는 각 워크스페이스의 다음 갱신 결제를 가장 빠른 순서로 추정합니다. plan_usd는 갱신 시 선불로 청구되는 요금제이며, 다운그레이드가 예약된 경우 다운그레이드될 티어의 가격입니다. overage_so_far_usd는 현재 기간에 포함된 통화 시간을 초과한 지금까지의 사용량입니다. 갱신 시 청구되며, 그때까지 계속 증가합니다.

upcoming = elevenlabs.reception.billing.list_upcoming_payments()
for payment in upcoming.payments:
print(
payment.workspace_name,
payment.subscription.billing_period_end_unix,
payment.plan_usd + payment.overage_so_far_usd,
)