Belgelere geç
MCP sunucusu

Faturalandırma

Plan, kullandıkça öde, faturalar ve ödeme bağlantıları.

Faturalandırma araçları

AraçNe yapar
getBillingÇalışma alanının planı ve neleri içerdiği, Planlar ve Faturalandırma’nın gösterdiği gibi: nasıl faturalandığı, ne zaman yenilendiği ya da bittiği ve sonraki ücret, alan adları, bu ayın gönderimleri, bugünün AI işlemleri ve kullandıkça öde.
listBillingPlansHer plan, en ucuzdan başlayarak, fiyatıyla, nerede satıldığıyla ve neleri içerdiğiyle.
getBillingUsageGün başına gönderimler ve AI işlemleri, ay başına kullandıkça öde ek kullanımının tutarı, Kullanım grafiklerinin gösterdiği gibi. days 3.660 güne kadar, all ise çalışma alanının oluşturulduğu güne kadar geriye gider.
listBillingAlertsUygulamanın faturalandırma bandının şu anda ne diyeceği, en acili önce.
listBillingCountriesBir fatura adresinin kabul ettiği her ülke kodu.
getPayAsYouGoKullandıkça öde: ek kullanımın faturalanıp faturalanmadığı, aylık sınır ve şimdiye kadarki tutar, geçerli dönem, seçilebilecek sınırlar ve fiyatlar.
setPayAsYouGoKullandıkça ödeyi açar ya da kapatır. İlk seferde kişinin kart eklediği bir bağlantı döndürür. Uygulamanın sohbetinde her zaman önce sorar.
setPayAsYouGoLimitKullandıkça ödenin aylık sınırını ayarlar. Uygulamanın sohbetinde her zaman önce sorar.
confirmPayAsYouGoKişi kartı ekledikten sonra kaydedildiğini kontrol eder ve bunu kaydeder. Uygulamanın sohbetinde her zaman önce sorar.
startPlanCheckoutÜcretsiz plandaki bir çalışma alanı için ücretli bir planın ödeme bağlantısı. Uygulamanın sohbetinde her zaman önce sorar.
openBillingPortalPlanın değiştirildiği ya da iptal edildiği ve kartın güncellendiği faturalandırma portalının bağlantısı. Uygulamanın sohbetinde her zaman önce sorar.
listInvoicesHer ücret, faturasının durumuyla, Planlar ve Faturalandırma’daki Geçmiş’in listelediği gibi, sayfa sayfa.
getInvoiceBir ücretin faturasının bağlantısı, bir PDF, çünkü bir araç dosya taşımaz.
saveBillingDetailsBir ücrette faturalanan adı ve adresi kaydeder, adresi sonraki ücretler için saklar ve faturasını yazmaya başlar. Uygulamanın sohbetinde her zaman önce sorar.

Faturalandırmaya yalnızca çalışma alanının sahibi, her adresle bağlanmış bir istemci üzerinden erişir. Okumak billing:read, her değişiklik ise billing:write gerektirir.

Bir araçla hiçbir şey ödenmez. Bir ödeme, faturalandırma portalı ve kullandıkça öde için kart eklemek her biri kişinin açacağı bir bağlantı döndürür; kişi orada öder, kartı değiştirir ya da iptal eder.

Bu sunucudaki bazı araçlar, REST API'nin bir doğrulama koduyla koruduğu bir değişiklik yapar ve aynı kodu ister. İstemci son 60 dakikada bir kod doğrulamadıkça ya da kişi Hesap → Bağlı uygulamalar'da onun için 60 dakika boyunca değişikliklere izin ver'i seçmedikçe böyle bir araç Refused (step_up_required): ile başlayan bir sonuçla yanıt verir ve hiçbir şeyi değiştirmez. emptyAudience hiçbir zaman kod istemez. API'nin Kimlik doğrulama sayfası kod isteyen her aracı listeler ve bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.

Referans

getBilling

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

The plan of this workspace and what it includes, as Plans & Billing shows it: how it is billed, when it renews or ends and the next charge, how many domains it holds, how much of this month's sends and today's AI actions are used, and pay as you go. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
GET /billing
SDK
billing.get()

listBillingPlans

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

Every plan, cheapest first, with its price, whether it is sold here and at which intervals, and what it includes. Prices are in US dollars. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
GET /billing/plans
SDK
billing.listPlans()

getBillingUsage

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

Sends and AI actions per day, and what pay as you go extras cost per month, as the Usage charts show them. days goes back 1 to 3660 days, 30 by default, and "all" goes back to the day the workspace was made. Days with no use are left out. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

daysinteger | string

Şurada da var

API
GET /billing/usage
SDK
billing.getUsage()

listBillingAlerts

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

What the billing banner of the app would say now, most urgent first: a failed payment, paused pay as you go, sending or AI paused at a limit, a plan about to end, an allowance nearly used and a charge coming soon. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
GET /billing/alerts
SDK
billing.listAlerts()

listBillingCountries

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

Every country a billing address can be in, as the two-letter ISO 3166 codes saveBillingDetails takes as country. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
GET /billing/countries
SDK
billing.listCountries()

getPayAsYouGo

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

Pay as you go on this workspace: whether usage past the allowances is billed, the monthly limit and what extras cost so far, the current billing period, the limits that can be chosen and the prices. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
GET /billing/pay-as-you-go
SDK
billing.getPayAsYouGo()

setPayAsYouGo

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

Turn pay as you go on or off, as the switch on Plans & Billing does. Off takes effect at once, and usage stops at the plan's allowances. On takes effect at once when a card is saved. The first time, it returns a link where the person adds a card on the billing provider's page: give them the link, and call confirmPayAsYouGo once they say they are done. Nothing is paid through this tool. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

enabledbooleanZorunlu
themestring

Light or dark, for the page the link opens. Left out, it follows the browser.

Şunlardan biri"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

En çok 35 karakter

Şurada da var

API
PATCH /billing/pay-as-you-go
SDK
billing.setPayAsYouGo()

setPayAsYouGoLimit

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

Set the monthly spending limit of pay as you go, in US cents. Extras stop for the rest of a calendar month once it is reached. Pay as you go has to be set up first. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

limitCentsintegerZorunlu

One of 1000, 2500, 5000, 10000, 25000, 50000, 100000, 250000, 500000.

Şurada da var

API
PUT /billing/pay-as-you-go/limit
SDK
billing.setPayAsYouGoLimit()

confirmPayAsYouGo

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

After the person added a card through the link setPayAsYouGo gave, check with the billing provider that it was saved and record it, as the app does when they come back. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

Girdi almaz.

Şurada da var

API
POST /billing/pay-as-you-go/confirm
SDK
billing.confirmPayAsYouGo()

startPlanCheckout

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

Start buying a paid plan for a workspace on Free, as choosing a plan in the app does, and return the link to the checkout on the billing provider's page. Nothing is charged until the person pays there, so give them the link. A workspace that already pays for a plan changes it with openBillingPortal instead. interval is month or year, month by default. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

planstringZorunlu
Şunlardan biri"starter""business""enterprise"
intervalstring
Şunlardan biri"month""year"
themestring

Light or dark, for the page the link opens. Left out, it follows the browser.

Şunlardan biri"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

En çok 35 karakter

Şurada da var

API
POST /billing/checkout
SDK
billing.startCheckout()

openBillingPortal

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

A link to the billing portal, where the person changes or cancels the plan, updates the card and downloads past invoices, as Manage does in the app. Nothing changes until they act there. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

themestring

Light or dark, for the page the link opens. Left out, it follows the browser.

Şunlardan biri"light""dark"
localestring

A language tag such as de or pt-PT, for the page the link opens.

En çok 35 karakter

Şurada da var

API
POST /billing/portal
SDK
billing.openPortal()

listInvoices

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

Every charge of the workspace with the state of its invoice, as History on Plans & Billing lists them, newest first unless sort is oldest. search matches the plan, the invoice number, the charge id and the name billed. getInvoice returns the link to an invoice. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

pageinteger
En az 1
limitinteger
En az 1En çok 100
sortstring
Şunlardan biri"newest""oldest"
searchstring
En çok 120 karakter

Şurada da var

API
GET /billing/invoices
SDK
billing.listInvoices()

getInvoice

Kapsamlarbilling:readUygulamadaki asistan sormadan çalıştırırAraç setibilling

The link to the invoice of one charge, a PDF, since a tool carries no file. An invoice that was not written yet is written first, which takes a few seconds. Take the charge id from listInvoices. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

orderIdstringZorunlu
Boş olamaz

Şurada da var

API
GET /billing/invoices/{orderId}
SDK
billing.getInvoice()

saveBillingDetails

Kapsamlarbilling:writeUygulamadaki asistan her zaman önce sorarAraç setibilling

Save the name and address billed on a charge, as the Billing address dialog does, keep the address for later charges, and start writing its invoice. country is a two-letter code from listBillingCountries, and in the US and Canada state is its two-letter code. It asks for a verification code, and in the app's chat it always asks first. Only the owner of the workspace reaches billing, through a client connected with every address.

Girdiler

orderIdstringZorunlu
Boş olamaz
namestringZorunlu
1 ile 200 karakter arası
line1stringZorunlu
1 ile 200 karakter arası
line2string
En çok 200 karakter
citystringZorunlu
1 ile 120 karakter arası
postalCodestring
En çok 40 karakter
statestring
En çok 60 karakter
countrystringZorunlu
Şunlardan biri"AD""AE""AF""AG""AI""AL""AM""AO""AQ""AR""AS""AT""AU""AW""AX""AZ""BA""BB""BD""BE""BF""BG""BH""BI""BJ""BL""BM""BN""BO""BQ""BR""BS""BT""BV""BW""BY""BZ""CA""CC""CD""CF""CG""CH""CI""CK""CL""CM""CN""CO""CR""CV""CW""CX""CY""CZ""DE""DJ""DK""DM""DO""DZ""EC""EE""EG""EH""ER""ES""ET""FI""FJ""FK""FM""FO""FR""GA""GB""GD""GE""GF""GG""GH""GI""GL""GM""GN""GP""GQ""GR""GS""GT""GU""GW""GY""HK""HM""HN""HR""HT""HU""ID""IE""IL""IM""IN""IO""IQ""IS""IT""JE""JM""JO""JP""KE""KG""KH""KI""KM""KN""KR""KW""KY""KZ""LA""LB""LC""LI""LK""LR""LS""LT""LU""LV""LY""MA""MC""MD""ME""MF""MG""MH""MK""ML""MM""MN""MO""MP""MQ""MR""MS""MT""MU""MV""MW""MX""MY""MZ""NA""NC""NE""NF""NG""NI""NL""NO""NP""NR""NU""NZ""OM""PA""PE""PF""PG""PH""PK""PL""PM""PN""PR""PS""PT""PW""PY""QA""RE""RO""RS""RW""SA""SB""SC""SD""SE""SG""SH""SI""SJ""SK""SL""SM""SN""SO""SR""SS""ST""SV""SX""SZ""TC""TD""TF""TG""TH""TJ""TK""TL""TM""TN""TO""TR""TT""TV""TW""TZ""UA""UG""UM""US""UY""UZ""VA""VC""VE""VG""VI""VN""VU""WF""WS""YE""YT""ZA""ZM""ZW"

Şurada da var

API
PUT /billing/invoices/{orderId}/details
SDK
billing.saveInvoiceDetails()