Juhendid

Saldo

Jääki, liikumiste ajalugu ja maksudokumente saate lugeda nii API kui ka MCP kaudu. Kaardimakse - nii ühekordne kui ka automaatne - läheb alati läbi Stripe Checkouti lingi, mille lõpetab inimene; API ise kaarti kunagi ei debiteeri. Sama kehtib valikulise kuupaketi kohta.

Raha ilma käibemaksuta, sendid, kirjelduse keel

Kõik selle API summad on täisarvud SENTIDES ja ilma käibemaksuta - volai on käibemaksukohustuslane, kuid käibemaks arvutatakse alles saldo täiendamisel kaardiga (ülevaade lehel /cenik). Liikumiste kirjeldused (GET /v1/credit/ledger) koostab API inglise keeles liikumise tüübi põhjal - salvestatud tšehhikeelne märkus ei lähe välja kunagi, ka mitte mõnes teises väljas.

Jääk, kestus ja märguanded

GET /v1/balance tagastab praeguse jäägi ning kaks täiendavat arvutust ADITIIVSELT (olemasolevad kliendid, kes loevad ainult balanceHal/balanceCzk/currency, ei lähe katki): runway (dailyAverageHal - keskmine päevakulu viimase aja põhjal, runwayDays - mitu päeva saldo selle tempo juures kestab, null, kui arvutada ei saa) ja notice - sama märguanne, mida näete portaalis lehel /prehled, null, kui märguannet pole. notice võib olla kaheksa kujuga: {kind:"unknown"} (hinnanguks pole piisavalt andmeid), {kind:"empty"} (jääk on null), {kind:"number_fee",feeHal,dueAt} (kõne- või mobiilinumbrite kuutasu langeb tähtajale 3 päeva jooksul ja jäägist ei piisa; feeHal on kõigi selliste tasude summa, dueAt varaseim tähtaeg; sisselülitatud automaattäienduse korral ei tagastata), {kind:"runway",days} (saldo saab otsa days päeva pärast praeguse tempo juures) ning neli kuju ainult kuupaketiga kontol: {kind:"subscription_exhausted_topup",renewsAt} (selle perioodi kuusaldo on ära kasutatud ja pakett töötab täiendamise režiimis, edasine kulu läheb täiendatud saldost; renewsAt on perioodi lõpp ms-des, mil uus kuusaldo lisatakse), {kind:"subscription_cap_reached",renewsAt} (kuusaldo on ära kasutatud, pakett töötab ülempiiriga ja täiendatud saldo ei kata midagi, tasulised toimingud on peatatud kuni renewsAt või käsitsi täiendamiseni) ja {kind:"subscription_past_due"} (paketi uuendamine ebaõnnestus, salvestatud kaarti ei õnnestunud debiteerida; uuenduse maksate portaalis või vahetate kaardi) ja {kind:"subscription_runway",renewsAt,runsOutAt} (jääk saab otsa enne, kui renewsAt lisatakse uus kuusaldo; runsOutAt on hinnang ms-des, millal see juhtub, paketi ettevaatliku tempo põhjal, mis on sama mis kuusaldo prognoos paketi kaardil portaalis: kõrgeim järgmistest - 28 päeva keskmine (ainult täieliku saldoajaloo korral), viimase 7 Praha päeva tegevuse keskmine ilma numbritasudeta ja perioodi algusest arvutatud keskmine (alles perioodi esimese nädala järel); runway arvutab edasi 28 päeva keskmisega; tellijale tagastatakse see runway asemel ja sisselülitatud automaattäienduse korral ei tagastata). renewsAt on ms-des (epoch), seega sama hetk mis subscription.periodEnd samas vastuses, kus see on ISO 8601 sõne; ühegi välja vorming ei muutu. Perioodi lõpus tühistatud paketi korral kannavad subscription_exhausted_topup, subscription_cap_reached ja subscription_runway lisaks cancelAtPeriodEnd: true: uuendust ei tule, renewsAt on paketi lõpp ja uut kuusaldot ei lisata (ülempiiri korral saab jätkata ainult täiendamisega); tühistamiseta seda välja märguandes ei ole. Kuupaketiga konto vastus kannab lisaks subscription (paketi olek, muidu null) ja topupBalanceHal (ainult täiendatud saldo); balanceHal jääb kuu- ja täiendatud saldo summaks, vt peatükki Kuupakett.

Liikumiste ajalugu

GET /v1/credit/ledger?limit - uusimad liikumised esimesena, ILMA kursorita (ainult limit, 1-200, vaikimisi 50) - vanemaid liikumisi kui 200 uusimat API kaudu kätte ei saa, kogu ajalugu ja maksudokumendid on portaalis /kredit. Iga kirje kannab type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - võtmed kätte tellimuse parandusvoor paketti ületavas ulatuses, subscription_grant - kuusaldo lisamine paketist ja subscription_expire - selle kasutamata jäägi aegumine), amountHal (positiivne liitmine, negatiivne mahaarvamine), grossHal (summa koos käibemaksuga kaardiga täiendamise korral, muidu null) ja inglisekeelset description, mis on koostatud tüübist - number_fee puhul lisaks numbriga, millega tasu seostub. Kuusaldoga kaetud kulude korral on lisaks väli fromSubscriptionHal - kulu osa, mille kattis kuusaldo; muudel liikumistel puudub. Mobiilinumbri lisand kuvatakse ajaloos kui number_fee (esimene periood ostul ja iga pikendus 30 päeva järel) ja sms (saatmine mobiilinumbrilt, segmendi hind on hinnakirjas); kui operaator mobiilinumbrilt saadetud SMS-i hiljem tagasi lükkab, tagastatakse saldo kirjega refund.

Täiendamine kaardiga

POST /v1/credit/topup {amountCzk} tagastab {checkoutUrl} - Stripe Checkouti lingi, mille avab INIMENE brauseris. Midagi ei debiteerita enne, kui ta maksme ise lõpetab. Arveldusaadress (PUT /v1/account/billing) peab olema täielik ENNE kutset - ilma selleta ei saa kehtivat maksudokumenti välja anda (billing_address_required). Toetab Idempotency-Key - pärast ajalõppu on ohutu korrata, ilma et tekiks kaks makset.

Automaattäiendus

API kaudu saab automaattäiendust ainult LUGEDA, VÄLJA LÜLITADA ja selle LÄVE muuta - sisselülitamine ja SUMMA muutmine käib eranditult läbi Stripe Checkouti, mitte kunagi otsese kirjutamisega.

Lugemine ja väljalülitamine

GET /v1/credit/auto-topup tagastab {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - ILMA kaardinumbrita, ainult kaubamärk ja viimased neli numbrit. PATCH {enabled: false} lülitab välja kohe, PATCH {thresholdHal} muudab ainult läve (peab olema pakutavast reast ja väiksem kui salvestatud summa, muidu langeb jääk pärast täiendamist kohe uuesti läve alla).

Sisselülitamine ja summa muutmine

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} tagastab {checkoutUrl} - pärast Checkouti lõpetamist debiteeritakse KOHE amountHal esimese täiendusena ja alles sellega salvestatakse kaart tulevaste automaattäienduste jaoks. Töötab ka varasemast ajast salvestatud kaardiga - see on ainus viis automaattäiendus sisse lülitada või selle summat muuta. Pärast Checkouti lõpetamist naaseb brauser portaali TŠEHHIKEELSELE lehele (/kredit?automat=zapnuto) ka ingliskeelsele kliendile - teadaolev puudus, mitte teie integratsiooni viga.

Kaart

POST /v1/credit/auto-topup/card tagastab Checkouti lingi (kaardivahetuse režiim, midagi ei debiteerita) salvestatud kaardi vahetamiseks. DELETE /v1/credit/auto-topup/card ühendab kaardi lahti KOHE - kustutatakse kogu seadistus (lävi ja summa), mitte ainult kaart; järgmine sisselülitamine käib ainult uuesti läbi .../setup, mis debiteerib kohe esimese täienduse. Pärast Checkouti lõpetamist naaseb brauser portaali TŠEHHIKEELSELE lehele (/kredit?karta=zmenena) olenemata konto keelest - sama teadaolev puudus nagu eespool.

Ülempiirid

Kaks OMAVAHEL SÕLTUMATUT ülempiiri: kuni 10 000 CZK lisatud saldot kalendrikuus ja kuni 4 täiendust KALENDRIPÄEVAS - olenemata sellest, mitu korda lävi alla langeb. Kummagi ületamisel lülitab automaattäiendus end ise välja (disabledReason monthly_cap vastavalt daily_cap); vastuse spentThisMonthHal/monthlyCapHal näitavad, kui palju kuuülempiirist on veel järel.

MCP: get_auto_topup (lugemine) ja disable_auto_topup (väljalülitamine) - sisselülitamist, summa muutmist ega kaarti MCP-s ei ole, samal põhjusel nagu enabled: true REST-is eespool.

Kuine kulupiir

Valikuline kaitse ootamatult suure arve vastu: määrate ise, kui palju võivad kõned, SMS-id ja häälagent kalendrikuus maksta (Praha aja järgi). Funktsioon on sisse lülitatud ainult kontol, mis on piiri seadnud; ilma selleta ei muutu midagi ja kuu kulu lihtsalt arvestatakse.

GET /v1/account/spend-cap tagastab {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Ilma piirita on enabled: false ja piiri väljad on null, monthSpendHal saate aga alati. Summad on täisarvuna sentides ilma käibemaksuta.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} seab või muudab piiri: capHal on täisarvuna sentides vahemikus 5 000 (50 CZK) kuni 100 000 000 (1 000 000 CZK), warnShare on piiri osa vahemikus 0,5 kuni 0,99 (vaikimisi 0,8), mille juures saadetakse hoiatuskiri, ja inboundAboveCap: true laseb agentidel jätkata sissetulevate kõnede vastuvõtmist ka üle piiri (vaikimisi false, muutmisel ilma väljata kehtib salvestatud väärtus). DELETE /v1/account/spend-cap tühistab piiri; olematu piiri tühistamine on korras.

Pärast piiri saavutamist lükatakse uued väljaminevad kõned, läbikutsed, proovikõned ja SMS-id tagasi koodiga spend_cap_reached (HTTP 402), midagi ei arveldata ja kordamine ei aita, kuni kuu lõpeb või te piiri tõstate või tühistate. Agendi sissetulev kõne lõpeb pärast ühte lauset ega maksa midagi, kui pole inboundAboveCap: true. E-kiri saadetakse warnShare saavutamisel ja piiri saavutamisel, alati kuni üks kord kuus.

Mida piir EI peata: parajasti käimasolevad kõned (hind arvestatakse alles pärast kõnet, seetõttu võib kuu lõppeda nende hinna võrra üle piiri, nagu ka pärast keskööd arveldatud kõnede puhul), suunamised ilma agendita ning numbritasud, võtmed kätte parandusvoor ja kuupakett, mida piiri arvestuses ei loeta. Paketiga konto kulusse loetakse ka see, mille kattis kuusaldo. Number Oma SIP-keskuses koos inboundAboveCap: true jääb SIP-puhvrisse, seega piir ei peata keskusest väljuvaid kõnesid.

MCP: get_spend_cap, set_spend_cap ja clear_spend_cap kasutavad sama teenust nagu REST ja portaal (jaotis Kuine kulupiir saldo all). set_spend_cap peab kliendile summa enne kirjutamist ja pärast seda kordama.

Kuupakett

Valikuline tellimus: iga kuu debiteeritakse salvestatud kaardilt valitud taseme hind ja lisatakse kuusaldo CZK-des, mida kulutatakse tavalise hinnakirja järgi. Hinnad ega sekundipõhine arveldus ei muutu, pakett on nende peal olev kiht. Tasemeid on kolm ja tier on nende hind CZK-des ilma käibemaksuta: "490", "990" ja "1990"; iga taseme hinna ja saldo tagastab GET /v1/subscription väljas tiers.

Kaks liiki saldot

Kuusaldo pärineb paketist, aegub perioodi lõpus ja on tagastamatu. Täiendatud saldo (täiendus, tervitusboonus, korrektsioon) ei aegu ja on tagastatav nagu varem. Konto jääk - balanceHal väljas GET /v1/balance, portaalis ja kõigis väravates (kõne miinimum, võlapiir, hoiatused) - on mõlema liigi summa. Ainult täiendatud saldo on väljas topupBalanceHal, allesjäänud kuusaldo väljas subscription.monthlyRemainingHal. Võlg võib tekkida ainult täiendatud saldos.

Kulutamise järjekord

Iga kulu läheb kõigepealt kuusaldost ja ülejäänu täiendatud saldost - sekundipõhised kõned, agent, numbri- ja mobiilinumbri tasud, SMS-id, läbikutsed ja väljaminevad ülesanded. Jaotus on aatomiline ja kirjutatud pearaamatusse: kuusaldoga kaetud kulu kannab fromSubscriptionHal (osa, mille kattis kuusaldo). Omaniku korrektsioonid (admin, ka negatiivsed) ja saatmata SMS-i tagastus (refund) puudutavad ainult täiendatud saldot.

Periood ja lisamine

Periood kestab ühe kuu alates eduka debiteerimise hetkest (31. 1. annab 28. 2.). Kuusaldo lisatakse alles pärast kinnitatud makset kirjega subscription_grant ja lisamine on makse id järgi idempotentne. Kui kontol on sel hetkel võlg täiendatud saldos, kaetakse see kõigepealt uuest kuusaldost, et täiendatud saldo ei jääks negatiivseks.

Aegumine

Kuusaldo kasutamata jääk aegub uuenduse päeval (kirje subscription_expire negatiivse summaga), tellimuse lõppemisel või automaatse kaitsega, kui periood lõppes enam kui 36 tundi tagasi ilma uuenduseta. Kui debiteerimine ebaõnnestub, on jääk juba aegunud ja uut saldot ei lisata; kuni maksmiseni töötab konto ainult täiendatud saldoga.

Valik pärast ammendumist

Sisselülitamisel tuleb kohustuslikult valida exhaustionMode, vaikeväärtust pole. topup: pärast kuusaldo ammendumist täiendatakse salvestatud kaardilt täiendatud saldot - see on praegune automaattäiendus samade piiride ja e-kirjadega. cap (ülempiir): midagi ei täiendata, väljaminevad kõned, SMS-id ja numbriostud lükatakse tagasi veaga subscription_cap_reached (HTTP 402) ning kui saldo langeb alla nulli, peatuvad ka sissetulevad kõned, suunamine ja SIP-juurdepääs (peatus nulli juures; jätkub pärast täiendamist või uue kuusaldoga). Ülempiiriga ei saa automaattäiendust sisse lülitada (subscription_cap_active); ülempiirile lülitumine lülitab selle välja. Kõige rohkem, mida ülempiiriga kuus maksate, on paketi hind.

Taseme muutmine, tühistamine, taastamine

Taseme muutmine (nii üles kui alla) kehtib alates järgmisest perioodist, ilma tasaarveldamiseta. Tühistamine on cancelAtPeriodEnd: true: saldo kehtib perioodi lõpuni, siis aegub ja olek on canceled; perioodi lõpuni saab tühistamise tagasi võtta. REST-i ega MCP kaudu ei saa taset tõsta, tühistatud paketti taastada ega kaardilt täiendamisele lülituda - need sammud suurendavad või lülitavad uuesti sisse korduvat debiteerimist, seetõttu tagastavad need subscription_confirmation_required koos confirmUrl-iga, mille inimene avab ja portaalis kinnitab (kehtib 24 tundi).

Nõuanne enne uuendust

Kolm päeva enne uuendust (hiljemalt päev varem) saadetakse e-kiri, aga ainult siis, kui senise kulu juures tuleks sekundipõhine tasumine või madalam tase odavam. Kehtib sama reegl nagu uuenduskirja ja portaali nõuandel: teine tee peab tulema vähemalt 50 CZK ja 5 % odavam. Hinnang kogu perioodile võtab kõrgema tempo perioodi algusest ja viimasest 7 päevast ega ole kunagi madalam kui viimase 30 päeva kulu, mille põhjal portaal nõu annab; read Tase ja Tühistamine seetõttu pärast klõpsu ei ütle, et tase sobib. E-kiri nimetab uuenduse täpse kuupäeva ja kellaaja ning saadetakse kuni üks kord perioodi kohta, mitte kunagi perioodi lõpus tühistatud paketi, planeeritud taseme muutuse, salvestatud kaardita või makset ootava paketi puhul. Selles olev nupp avab portaalis otse rea Tühistamine (/kredit?pausal=zrusit) või Tase (/kredit?pausal=stupen). Uuenduskiri annab seejärel nõu uuesti kogu perioodi tegeliku kulu põhjal, seega võib nõu tulla ka teistsugune.

Tasumata uuendus

Salvestatud kaardilt debiteerimist proovitakse uuenduse päeval, 2 ja 4 päeva pärast. Pärast esimest ebaõnnestumist on olek past_due, saadetakse e-kiri käsitsi makse ja kaardivahetuse lingiga ning kuusaldo on 0; käsitsi makse tagastab POST /v1/subscription/pay. Pärast kolmandat ebaõnnestumist pakett lõpeb (canceled), täiendatud saldo ja konto töötavad edasi.

Käibemaks ja dokumendid

Hinnad on ilma käibemaksuta. Käibemaksurežiim loetakse enne iga debiteerimist, seega maksab teisest ELi riigist pärit käibemaksukohustuslane kehtiva käibemaksukoodiga ilma Tšehhi käibemaksuta (pöördmaksustamine) ja dokument seda kajastab. Maksudokumendi iga tasutud perioodi eest väljastab volai ise (maksustatav alus on taseme hind, mitte lisatud saldo) ja leiate selle GET /v1/billing/documents alt.

Seos boonuse ja esimese täiendusega

Paketi sisselülitamine loetakse esimeseks makseks: avab SMS-id jagatud saatjalt, suunamise, teise numbri, mobiilinumbri ja automaattäienduse kaardi samamoodi nagu täiendus. Tervitusboonus jääb täiendatud saldoks.

Tagastatavus

Kuusaldo on tagastamatu ja aegub; täiendatud saldo on tagastatav nagu varem. Paketi tühistamine ei anna õigust tasutud perioodi proportsionaalsele osale. Paketi makse tagastamise (kaebus, eksitus) lahendab volai omanik käsitsi, API ega MCP kaudu see ei käi.

Kuupakett REST-is ja MCP-s

Raha liigub ainult siis, kui inimene on kaardi juures. Paketi sisselülitamine ja käsitsi makse tagastavad ainult Stripe Checkouti lingi ega debiteeri kunagi kaarti otse; taseme tõstmine, perioodi lõppu seatud paketi taastamine ja kaardilt täiendamisele lülitumine nõuavad sisselogitud inimese kinnitust portaalis.

• GET /v1/subscription - paketi olek (subscription või null), tasemete kataloog tiers (id, priceHal, creditHal), topupBalanceHal, available (uue paketi saab sisse lülitada: pakkumine on sees ja ühtegi paketti ei tööta), recommendation (odavaim tee viimase 30 päeva kulu jaoks ja steady, kas kulu on püsiv, mitte vaid ühekordne tipp; null ilma pakkumiseta või ilma 30 päeva ajaloota) ja previousPeriod (eelmine periood samade numbritega nagu uuenduskirjas: usedHal väljast creditHal, usedPercent, kuusaldot ületav kulu overHal ja aegunud jääk expiredHal; ainult aktiivse paketi puhul, null esimeses perioodis ja kui kulu ei saa ajaloost tõendada).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - tagastab {checkoutUrl} Stripe Checkouti jaoks, mille lõpetamisel pakett algab. exhaustionMode (topup või cap) on kohustuslik; registrikoodita tarbija peab saatma consumerConsent: true (muidu consumer_consent_required). Arveldusaadress peab olema täielik (billing_address_required). Toetab Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - taseme langetamise, tühistamise (cancelAtPeriodEnd: true) ja ülempiirile lülitumise (exhaustionMode: "cap") teeb ära ja tagastab {subscription}. Taseme tõstmine, perioodi lõppu seatud paketi taastamine (cancelAtPeriodEnd: false) ja exhaustionMode: "topup" ei muuda midagi ja tagastavad 409 subscription_confirmation_required koos confirmUrl-iga.
• POST /v1/subscription/pay - ainult olekus past_due; tagastab {checkoutUrl} uuenduse käsitsi tasumiseks. Toetab Idempotency-Key.
• POST /v1/subscription/card - tagastab {checkoutUrl} paketi salvestatud kaardi vahetamiseks, midagi ei debiteerita. Toetab Idempotency-Key.
• GET /v1/balance kannab lisaks subscription (sama kuju nagu eespool, muidu null) ja topupBalanceHal.

MCP: get_subscription (lugemine), create_subscription_link (sisselülitamise link), update_subscription ja cancel_subscription (taseme langetamine, tühistamine, ülempiir; tõstmine, taastamine ja täiendamine tagastavad confirmUrl-i koos lausega, et selle peab portaalis kinnitama inimene) ja create_subscription_payment_link (käsitsi makse). Kaardivahetust MCP-s ei ole, samal põhjusel nagu automaattäienduse puhul: siit ei debiteerita midagi.

Maksudokumendid

Dokument tekib automaatselt saldo täiendamisel kaardiga (nii ühekordsel kui ka automaatsel), võtmed kätte seadistuse tasumisel ja parandusdokumendina seadistuse tagastamisel - ei mingit käsitsi sammu, ei mingit väljastamist API kaudu.

GET /v1/billing/documents?limit&before - uusimad esimesena, kursor before (Unix ms, välistav) on eelmise lehe nextBefore. Hoidla ise ei tagasta kunagi rohkem kui 100 kirjet kutse kohta, isegi kui limit nõuab rohkem.

GET /v1/billing/documents/{id} tagastab {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true teisest ELi riigist pärit maksukohustuslastel kehtiva käibemaksukoodiga (VIES), kes maksavad ilma Tšehhi käibemaksuta. Väli kind on alati täidetud - "invoice" tavalise dokumendi puhul (ka enne välja kasutuselevõttu väljastatud dokumentidel), "credit_note" parandusdokumendi puhul - see tekib automaatselt, kui omanik tagastab tühistatud võtmed kätte tellimuse seadistuse hinna, nummerdatakse oma reaga OD... ja kannab lisaks correctsNumber (parandatava dokumendi number) ja correctionReason (tagastuse põhjus); summad netHal/vatHal/grossHal on ka kreeditarve puhul POSITIIVSED, miinusmärgi annab alles PDF.

GET /v1/billing/documents/{id}/pdf laadib alla sama dokumendi kujul application/pdf - koostatakse iga allalaadimise ajal värskelt, ei salvestata. Võõra või olematu id korral teatab mõlemal lõpppunktil sama viga (invoice_not_found), et vastusest ei saaks välja lugeda, et võõras dokument on olemas.

MCP: list_billing_documents ja get_billing_document on sama kujuga nagu REST. PDF on ainult REST-is - MCP-l pole faili edastamiseks binaarkanalit.

Vead

• ledger_unavailable - Liikumiste ajaloo ega jäägi lugemine praegu ei õnnestu - proovige hetke pärast uuesti.
• invalid_amount - Täienduse, läve või automaatmakse summa ei ole ükski pakutavatest fikseeritud väärtustest.
• billing_address_required - Arveldusaadress puudub või on poolik - täiendage see portaalis (/nastaveni) enne täiendamist, muidu ei saa kehtivat dokumenti välja anda.
• stripe_not_configured - Maksed on selle volai käitamise jaoks välja lülitatud - ei puuduta teie konkreetset päringut.
• stripe_error - Stripe keeldus makseseanssi loomast - proovige hetke pärast uuesti.
• autotopup_not_configured - Automaattäiendus pole veel kunagi läbinud .../setup - pole midagi välja lülitada, muuta ega millist kaarti vahetada.
• invoice_not_found - Sellise id-ga dokumenti kontol ei ole (või kuulub see teisele kontole - vastus on sama).
• spend_cap_reached - Teie seatud kuine kulupiir on saavutatud: uued väljaminevad kõned ja SMS-id lükatakse tagasi ja midagi ei arveldata. Piiri tõstate või tühistate PUT või DELETE /v1/account/spend-cap kaudu, muidu kehtib see kuu lõpuni (kuni keskööni Praha aja järgi).
• subscription_cap_reached - Paketi ülempiir: nii kuu- kui ka täiendatud saldo on ammendatud ja kontol on valitud ülempiir. Väljaminevad kõned, SMS-id ja numbriostud lükatakse tagasi (HTTP 402) kuni järgmise uuenduse või käsitsi täiendamiseni.
• subscription_exists - Kontol on pakett juba olemas; taseme muutmine, tühistamine ja valik pärast ammendumist käivad PATCH /v1/subscription kaudu.
• subscription_missing - Kontol pole aktiivset paketti, mida saaks muuta, tühistada või käsitsi tasuda.
• subscription_canceled - Pakett on juba lõppenud (olek canceled): seda ei saa muuta, tühistada ega käsitsi tasuda. Uue lülitate sisse POST /v1/subscription/checkout kaudu.
• subscription_confirmation_required - Taseme tõstmise, perioodi lõppu seatud paketi taastamise ja kaardilt täiendamise kinnitab ainult inimene portaalis - vastus kannab confirmUrl-i ja midagi ei muutunud.
• consumer_consent_required - Registrikoodita tarbija peab sisselülitamisel kinnitama selge taotluse teenuse osutamise alustamiseks enne taganemisõiguse tähtaja möödumist (consumerConsent: true).
• pausal_unavailable - Paketi pakkumine on selle konto jaoks praegu välja lülitatud.
• invalid_tier - Tase, mis paketil juba on, kui muud taset pole planeeritud (tase, millele juba üle minnakse, ei ole viga ja loetakse tehtuks, seega sama PATCH /v1/subscription saab pärast katkestust uuesti saata; erandiks on naasmine praegusele tasemele, mis tühistab planeeritud muutuse: kordamisel pole enam midagi tühistada); tundmatu väärtus väljaspool "490", "990", "1990" lõpeb kui validation.
• subscription_cap_active - Ülempiiriga ei saa automaattäiendust sisse lülitada; lülitage portaalis valik pärast ammendumist kõigepealt topup-ile.
• validation - Konkreetselt PATCH /v1/credit/auto-topup korral: katse sisse lülitada (enabled: true) või muuta amountHal otse - kasutage selle asemel POST .../setup.

Iga lõpppunkti täielik veatabel on jaotises Saldo REST API viites.