Föst áskrift
Sama upphæð á hverju tímabili. Hentar fyrir áskriftarleiðir eins og Grunn, Pro og Fyrirtæki.
usage_type: "licensed"Föst mánaðargjöld, sæti eða notkun mæld niður í einstök API-köll. Borga heldur utan um tímabilin, reiknar upphæðina, gefur út reikning í bókhaldskerfinu þínu og innheimtir af korti eða með kröfu í netbanka.
Áskrift í Borga er safn af verðum. Hvert verð getur verið fast, eftir sætum eða eftir notkun, og þú getur blandað þeim saman í eina áskrift á einum reikningi.
Sama upphæð á hverju tímabili. Hentar fyrir áskriftarleiðir eins og Grunn, Pro og Fyrirtæki.
usage_type: "licensed"Magn sinnum einingarverð. Fjölgaðu eða fækkaðu sætum á miðju tímabili og Borga reiknar mismuninn hlutfallslega.
quantity: 8Notkun safnast á mæli yfir tímabilið og er verðlögð eftir þrepum þegar það lokast. API-köll, tókar, gígabæti, sendingar.
usage_type: "metered"Fast gjald með innifalinni notkun og einum eða fleiri mælum ofan á. Innifaldar einingar dragast frá áður en umframnotkun er rukkuð.
included_units: 10_000Þú sendir atburði úr kerfinu þínu. Mælirinn síar þá og safnar saman í magn og verðið ákveður hvað magnið kostar. Af því að mælir og verð eru aðskilin getur þú breytt verðskránni án þess að snerta kóðann sem sendir atburði.
Stakir atburðir eða allt að 1.000 í einu. Idempotency-lykill tryggir að endursending tvítelji aldrei.
POST /v1/events/batchMælirinn velur atburði eftir nafni og lýsigögnum og reiknar magn tímabilsins.
{ "metadata.tier": "pro" }Innifaldar einingar dragast frá og afgangurinn er verðlagður eftir stigvaxandi eða magnþrepum.
tiers_mode: "graduated"Í lok tímabils verður notkunin að línu á reikningi, bókuð og innheimt með föstu gjöldunum.
invoice.finalizedSumma gildis í lýsigögnum atburðanna.
Dæmi: Tókar, gígabæti flutt, mínútur
Vísaðu í viðskiptavin með þínu eigin notandanúmeri í gegnum external_customer_id. Engin þörf á að geyma Borga-auðkenni.
unit_multiplier leyfir þér að geyma hráa tóka og verðleggja á hverja milljón. unit_label birtist á reikningnum.
Sæktu notkun, innifaldar einingar og umframnotkun viðskiptavinar hvenær sem er á tímabilinu.
| timestamp | metadata.user_id | metadata.total_tokens |
|---|---|---|
| 12:00:01 | user_a | 640 |
| 12:00:04 | user_b | 1.024 |
| 12:00:09 | user_a | 212 |
| 12:00:15 | user_c | 890 |
| 12:00:22 | user_a | 1.534 |
Dæmi: skjalavinnsla með 500 innifalin skjöl á mánuði. Umframnotkun er verðlögð í þremur þrepum. Dragðu sleðann og berðu saman stigvaxandi þrep og magnþrep.
Þrepin gilda um notkun umfram innifaldar einingar. Með credit_rollover flytjast ónotaðar innifaldar einingar yfir á næsta tímabil.
Hvert þrep er verðlagt sér. Fyrstu 1.000 umfram á 45 kr., næstu á 30 kr. og svo framvegis.
Við 80% af innifalinni notkun sendir Borga usage.high_watermark svo þú getir varað viðskiptavininn við.
Prufutími, uppfærslur, afslættir, hlé og misheppnaðar greiðslur. Allt sem venjulega endar sem cron-verk og töflureiknir er innbyggt, og hver breyting sendir vefkrók.
Gefðu ókeypis daga áður en fyrsta tímabilið hefst. Áskriftin verður virk sjálfkrafa þegar prufutíma lýkur.
trial_period_days: 14Breyttu verði eða fjölda sæta á miðju tímabili. Veldu hvort mismunurinn fer á næsta reikning, er rukkaður strax eða sleppt.
proration_behavior: "always_invoice"Prósentu- eða upphæðarafsláttur á næsta reikning. Bættu við stökum línum, eins og ráðgjöf eða uppsetningu, eða inneign.
discount: { percent_off: 20 }Settu áskrift í hlé og engir reikningar verða til. Haltu áfram síðar á sama tímabilsás.
subscriptions.pause(id)Segðu upp í lok tímabils og viðskiptavinurinn heldur aðgangi út tímabilið. Skipti hann um skoðun afturkallar þú uppsögnina.
subscriptions.uncancel(id)Misheppnist greiðsla reynir Borga aftur fjórum sinnum, með 1, 3, 5 og 7 daga millibili. Nýtt kort sem viðskiptavinur vistar er notað í næstu tilraun.
invoice.payment_failed→ Áskrift fer í past_due og subscription.past_due er sent
Veldu hvernig hver áskrift er innheimt. Hvort sem er verður til sölureikningur í bókhaldskerfinu þínu á hverju tímabili, með bókhaldslykli á hverri línu.
collection_method: "charge_automatically"collection_method: "send_invoice"Bókhaldskerfið gefur út reikninginn og Borga geymir tilvísun í hann. Engin handvirk færsla í lok mánaðar.
Stofnaðu mæli og verð einu sinni, áskrift fyrir hvern viðskiptavin og sendu notkun eftir því sem hún verður til. Borga sér um afganginn.
// Mælir sem leggur saman tóka úr hverju svari
const meter = await borga.meters.create({
name: "LLM tókar",
event_name: "llm_completion",
aggregate_type: "sum",
aggregate_property: "metadata.total_tokens",
unit_label: "tókar",
unit_multiplier: 1_000_000, // verðlagt á hverja milljón
});Gefðu viðskiptavinum þínum yfirsýn yfir áskriftina og notkunina, inni í þinni vöru eða á síðu frá Borga.
Búðu til tímabundinn hlekk og viðskiptavinurinn sér alla reikninga, sækir PDF og greiðir opna reikninga. Engin innskráning.
POST /v1/customer_portalsEitt kall skilar virkum áskriftum og stöðu allra mæla. Byggðu notkunarskjá eða viðvörun áður en þakið er náð.
GET /v1/customer-state/:idHver breyting á áskrift, reikningi og notkun sendir undirritaðan vefkrók, svo aðgangur í þinni vöru fylgi alltaf stöðunni.
subscription.updatedSkjölunin fer í smáatriðin: öll svið, stöður, vefkrókar og kóðadæmi sem eru prófuð gegn SDK-inu.