Hoppa till navigering

Prenumerationer och fakturering

Sälj, ändra och avsluta dina kunders planer, och följ vad ditt kort debiteras.

Varje kundarbetsyta kan ha en prenumeration på en nivå som du säljer. Ditt återförsäljarkort betalar fakturorna för varje arbetsyta. En arbetsytas aktuella prenumeration finns i fältet subscription i workspaces.list, tillsammans med has_payment_issue.

Tilldela en plan

Prenumerera på en arbetsyta som ännu inte har någon plan. billing_period är monthly_period (standard) eller 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",
)

Skicka en idempotency_key som du genererar vid varje tilldelning eller ändring. Om en begäran får timeout kan du försöka igen med samma nyckel utan att arbetsytan prenumererar eller debiteras två gånger.

Tilldelning eller ändring av en plan nekas när has_payment_issue är true. Visa den obetalda fakturan för kunden, eller betala den via pay_url, innan du försöker igen.

Ändra en plan

subscriptions.change tar samma body som assign.

  • En uppgradering tillämpas direkt.
  • En nedgradering eller flytt till en nivå på samma nivå träder i kraft vid slutet av faktureringsperioden. Fram till dess visar prenumerationen den nya nivån i pending_downgrade_tier och datumet i pending_downgrade_at_unix.

För att behålla arbetsytan på dess nuvarande nivå tar du bort den schemalagda nedgraderingen med subscriptions.cancel_pending_downgrade.

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

När en nedgradering träder i kraft inaktiveras receptionister och telefonnummer utöver den nya planens gränser, och teammedlemmar utöver dess teamstorlek stängs av.

Avsluta en plan

subscriptions.unassign avslutar prenumerationen i slutet av den aktuella faktureringsperioden. Fram till dess visar cancel_at_unix när den avslutas, och subscriptions.restore ångrar uppsägningen så att planen förnyas som vanligt.

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

Fakturor

Varje debitering av ditt kort betalar en arbetsytas faktura. billing.list_invoices returnerar dem med de senaste först, en sida i taget. En fakturas status är en av följande:

StatusBetydelse
paidKortet har debiterats.
openKortet försöker fortfarande debiteras. pay_url länkar till en betalningssida.
voidAlla försök misslyckades och arbetsytans plan avslutades.

billing.get_invoice lägger till fakturans lines. En rad med negativt amount_cents är en proportionell kredit, och raderna summerar alltid till debiteringen.

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)

Kommande betalningar

billing.list_upcoming_payments uppskattar nästa förnyelse för varje arbetsyta, med den närmaste först. plan_usd är planen som förnyelsen debiterar i förskott, vilket är priset för den nedgraderade nivån när en nedgradering är schemalagd. overage_so_far_usd är den här periodens användning utöver de inkluderade minuterna hittills. Den debiteras vid förnyelsen och fortsätter att öka fram till dess.

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,
)