Kalo te dokumentacioni
Serveri MCP

Faturimi

Plani, pagesa sipas përdorimit, faturat dhe lidhjet për të paguar.

Veglat e faturimit

VeglaÇfarë bën
getBillingPlani i hapësirës së punës dhe çfarë përfshin, siç e tregon Planet dhe faturimi: si faturohet, kur rinovohet ose mbaron dhe tarifa e radhës, domenet, dërgimet e këtij muaji, veprimet AI të sotme dhe pagesa sipas përdorimit.
listBillingPlansÇdo plan, nga më i liri, me çmimin e tij, ku shitet dhe çfarë përfshin.
getBillingUsageDërgimet dhe veprimet AI për ditë, dhe sa kushtojnë për muaj shtesat e pagesës sipas përdorimit, siç i tregojnë grafikët e Përdorimit. days shkon pas deri në 3.660 ditë, dhe all deri në ditën kur u krijua hapësira e punës.
listBillingAlertsÇfarë do të thoshte tani shiriti i faturimit në aplikacion, më urgjentja e para.
listBillingCountriesÇdo kod vendi që pranon një adresë faturimi.
getPayAsYouGoPagesa sipas përdorimit: nëse shtesat faturohen, kufiri mujor dhe sa kushtojnë deri tani, periudha aktuale, kufijtë që mund të zgjidhen dhe çmimet.
setPayAsYouGoAktivizo ose çaktivizo pagesën sipas përdorimit. Herën e parë kthen një lidhje ku personi shton një kartë. Në chat-in e aplikacionit pyet gjithmonë së pari.
setPayAsYouGoLimitCakto kufirin mujor të pagesës sipas përdorimit. Në chat-in e aplikacionit pyet gjithmonë së pari.
confirmPayAsYouGoPasi personi të ketë shtuar kartën, kontrollon që u ruajt dhe e regjistron. Në chat-in e aplikacionit pyet gjithmonë së pari.
startPlanCheckoutLidhja e një pagese për një plan me pagesë, për një hapësirë pune në planin Falas. Në chat-in e aplikacionit pyet gjithmonë së pari.
openBillingPortalLidhja e portalit të faturimit, ku plani ndryshohet ose anulohet dhe karta përditësohet. Në chat-in e aplikacionit pyet gjithmonë së pari.
listInvoicesÇdo tarifë me gjendjen e faturës së saj, siç i rendit Historiku te Planet dhe faturimi, një faqe në një kohë.
getInvoiceLidhja e faturës së një tarife, një PDF, meqë një vegël nuk mbart skedarë.
saveBillingDetailsRuaj emrin dhe adresën e faturuar në një tarifë, mbaj adresën për tarifat e mëvonshme dhe nis shkrimin e faturës së saj. Në chat-in e aplikacionit pyet gjithmonë së pari.

Vetëm pronari i hapësirës së punës e arrin faturimin, përmes një klienti të lidhur me çdo adresë. Leximi kërkon billing:read dhe çdo ndryshim kërkon billing:write.

Asgjë nuk paguhet përmes një vegle. Një pagesë, portali i faturimit dhe shtimi i një karte për pagesën sipas përdorimit kthejnë secili një lidhje që personi e hap, dhe atje ai paguan, ndryshon kartën ose anulon.

Disa mjete në këtë server bëjnë një ndryshim që REST API e mbron me kod verifikimi, dhe kërkojnë të njëjtin kod. Derisa klienti të ketë verifikuar një kod në 60 minutat e fundit, ose personi të ketë zgjedhur Lejo ndryshimet për 60 minuta për të te Llogaria → Aplikacionet e lidhura, një mjet i tillë përgjigjet me një rezultat që nis me Refused (step_up_required): dhe nuk ndryshon asgjë. emptyAudience nuk kërkon kurrë kod. Faqja Autentikimi e API-t rendit çdo mjet që kërkon kod, dhe tregon si kërkohet dhe verifikohet një kod.

Referencë

getBilling

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

API
GET /billing
SDK
billing.get()

listBillingPlans

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

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

getBillingUsage

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

daysinteger | string

E disponueshme edhe në

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

listBillingAlerts

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

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

listBillingCountries

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

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

getPayAsYouGo

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

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

setPayAsYouGo

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

enabledbooleanE detyrueshme
themestring

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

Një nga"light""dark"
localestring

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

Deri në 35 karaktere

E disponueshme edhe në

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

setPayAsYouGoLimit

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

limitCentsintegerE detyrueshme

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

E disponueshme edhe në

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

confirmPayAsYouGo

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

Nuk merr asnjë hyrje.

E disponueshme edhe në

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

startPlanCheckout

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

planstringE detyrueshme
Një nga"starter""business""enterprise"
intervalstring
Një nga"month""year"
themestring

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

Një nga"light""dark"
localestring

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

Deri në 35 karaktere

E disponueshme edhe në

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

openBillingPortal

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

themestring

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

Një nga"light""dark"
localestring

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

Deri në 35 karaktere

E disponueshme edhe në

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

listInvoices

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

pageinteger
Të paktën 1
limitinteger
Të paktën 1Më së shumti 100
sortstring
Një nga"newest""oldest"
searchstring
Deri në 120 karaktere

E disponueshme edhe në

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

getInvoice

Lejetbilling:readAsistenti i aplikacionit e ekzekuton pa pyeturPaketa e mjetevebilling

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.

Hyrjet

orderIdstringE detyrueshme
Jo bosh

E disponueshme edhe në

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

saveBillingDetails

Lejetbilling:writeAsistenti i aplikacionit pyet gjithmonë më parëPaketa e mjetevebilling

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.

Hyrjet

orderIdstringE detyrueshme
Jo bosh
namestringE detyrueshme
Nga 1 deri në 200 karaktere
line1stringE detyrueshme
Nga 1 deri në 200 karaktere
line2string
Deri në 200 karaktere
citystringE detyrueshme
Nga 1 deri në 120 karaktere
postalCodestring
Deri në 40 karaktere
statestring
Deri në 60 karaktere
countrystringE detyrueshme
Një nga"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"

E disponueshme edhe në

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