Vodniki

Dobroimetje

Stanje, zgodovino gibanj in davčne dokumente berete prek API-ja in MCP. Plačilo s kartico - enkratno in samodejno - vedno poteka prek povezave Stripe Checkout, ki jo dokonča človek; API sam nikoli ne obremeni kartice. Enako velja za neobvezni mesečni paket.

Denar brez DDV, stotinke, jezik opisov

Vsi zneski v tem API-ju so cela števila v STOTINKAH (hellerjih) in brez DDV - volai je zavezanec za DDV, vendar se DDV izračuna šele ob polnjenju dobroimetja s kartico (pregled na /cenik). Opise gibanj (GET /v1/credit/ledger) API sestavi v angleščini iz vrste gibanja - shranjena češka opomba nikoli ne gre ven, tudi ne v drugem polju.

Stanje, doseg in obvestila

GET /v1/balance vrne trenutno stanje in dva dodatna izračuna ADITIVNO (obstoječi odjemalci, ki berejo samo balanceHal/balanceCzk/currency, se ne pokvarijo): runway (dailyAverageHal - povprečna dnevna poraba iz zadnjega obdobja, runwayDays - koliko dni dobroimetje zadošča pri takem tempu, null, kadar se ne da izračunati) in notice - isto obvestilo, kot ga vidite na pregledu v portalu (/prehled), null, kadar ga ni. Osem možnih oblik notice: {kind:"unknown"} (premalo podatkov za oceno), {kind:"empty"} (ničelno stanje), {kind:"number_fee",feeHal,dueAt} (v 3 dneh zapade mesečni strošek za glasovne ali mobilne številke in stanje ne zadošča; feeHal je vsota vseh takih stroškov, dueAt najzgodnejši rok zapadlosti; ob vklopljenem samodejnem polnjenju se ne vrne), {kind:"runway",days} (dobroimetje bo pri trenutnem tempu pošlo čez days dni) in štiri oblike samo pri računu z mesečnim paketom: {kind:"subscription_exhausted_topup",renewsAt} (mesečno dobroimetje tega obdobja je porabljeno in paket deluje v načinu doplačevanja, nadaljnja poraba gre iz napolnjenega dobroimetja; renewsAt je konec obdobja v ms, ko se pripiše novo mesečno dobroimetje), {kind:"subscription_cap_reached",renewsAt} (mesečno dobroimetje je porabljeno, paket deluje z omejitvijo in napolnjeno dobroimetje ne krije ničesar, plačljiva dejanja stojijo do renewsAt ali do ročnega polnjenja) in {kind:"subscription_past_due"} (obnova paketa ni uspela, shranjene kartice ni bilo mogoče obremeniti; obnovo plačate v portalu ali zamenjate kartico) in {kind:"subscription_runway",renewsAt,runsOutAt} (stanje pošle prej, kot se ob renewsAt pripiše novo mesečno dobroimetje; runsOutAt je ocena v ms, kdaj pošle, iz previdnega tempa paketa, enakega kot napoved mesečnega dobroimetja na kartici paketa v portalu: najvišja od povprečja za 28 dni (samo pri popolni zgodovini dobroimetja), povprečja poslovanja v zadnjih 7 praških dneh brez stroškov za številke in povprečja od začetka obdobja (šele po njegovem prvem tednu); runway še naprej računa s povprečjem za 28 dni; naročnik dobi to obliko namesto runway in ob vklopljenem samodejnem polnjenju je ne dobi). renewsAt je v ms (epoch), torej isti trenutek kot subscription.periodEnd v istem odgovoru, kjer je niz ISO 8601; format nobenega od obeh polj se ne spremeni. Pri paketu, preklicanem ob koncu obdobja, subscription_exhausted_topup, subscription_cap_reached in subscription_runway dodatno nosijo cancelAtPeriodEnd: true: obnove ne bo, renewsAt je konec paketa in novo mesečno dobroimetje se ne pripiše (pri omejitvi lahko nato nadaljujete samo s polnjenjem); brez preklica polja v obvestilu ni. Pri računu z mesečnim paketom odgovor dodatno nosi subscription (stanje paketa, sicer null) in topupBalanceHal (samo napolnjeno dobroimetje); balanceHal ostaja vsota mesečnega in napolnjenega dobroimetja, glej poglavje Mesečni paket.

Zgodovina gibanj

GET /v1/credit/ledger?limit - najnovejša gibanja najprej, BREZ kazalca (samo limit, 1-200, privzeto 50) - starejših gibanj, kot je najnovejših 200, prek API-ja ne dosežete, celotno zgodovino ima portal /kredit in davčni dokumenti. Vsak zapis nosi type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - krog popravkov naročila Na ključ, ki presega paket, subscription_grant - pripis mesečnega dobroimetja iz paketa in subscription_expire - zapadlost njegovega neporabljenega ostanka), amountHal (pozitivno je pripis, negativno odtegljaj), grossHal (znesek z DDV pri polnjenju s kartico, sicer null) in angleški description, sestavljen iz vrste - pri number_fee dodatno s številko, na katero se strošek nanaša. Pri porabi, krito z mesečnim dobroimetjem, je dodatno polje fromSubscriptionHal - del porabe, ki ga je krilo mesečno dobroimetje; pri drugih gibanjih ga ni. Dodatek mobilna številka se v zgodovini pokaže kot number_fee (prvo obdobje ob nakupu in vsaka obnova po 30 dneh) in sms (pošiljanje s mobilne številke, cena na segment je v ceniku); če operater SMS s mobilne številke naknadno zavrne, se dobroimetje vrne z zapisom refund.

Polnjenje s kartico

POST /v1/credit/topup {amountCzk} vrne {checkoutUrl} - povezavo Stripe Checkout, ki jo odpre ČLOVEK v brskalniku. Nič se ne obremeni, dokler plačila sam ne dokonča. Plačilni naslov (PUT /v1/account/billing) mora biti popoln PRED klicem - brez njega ni mogoče izdati veljavnega davčnega dokumenta (billing_address_required). Podpira Idempotency-Key - po časovni omejitvi je ponovitev varna, ne da bi nastali dve plačili.

Samodejno polnjenje

Prek API-ja se samodejno polnjenje lahko samo BERE, IZKLOPI in spremeni PRAG - vklop in sprememba ZNESKA gresta izključno prek Stripe Checkout, nikoli z neposrednim zapisom.

Branje in izklop

GET /v1/credit/auto-topup vrne {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - BREZ številke kartice, samo znamka in zadnje štiri števke. PATCH {enabled: false} izklopi takoj, PATCH {thresholdHal} spremeni samo prag (biti mora iz ponujene vrste in nižji od shranjenega zneska, sicer po polnjenju stanje takoj spet pade pod prag).

Vklop in sprememba zneska

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} vrne {checkoutUrl} - po dokončanju Checkouta se TAKOJ obremeni amountHal kot prvo polnjenje in šele s tem se shrani kartica za prihodnja samodejna polnjenja. Deluje tudi s kartico, ki je bila shranjena že prej - to je edina pot, kako samodejno polnjenje vklopiti ali mu spremeniti znesek. Po dokončanju Checkouta se brskalnik vrne na ČESKO stran portala (/kredit?automat=zapnuto) tudi pri strankah, ki govorijo angleško - znana vrzel, ne napaka vaše integracije.

Kartica

POST /v1/credit/auto-topup/card vrne povezavo Checkout (način zamenjave kartice, nič se ne obremeni) za zamenjavo shranjene kartice. DELETE /v1/credit/auto-topup/card kartico odklopi TAKOJ - izbriše se celotna konfiguracija (prag in znesek), ne samo kartica; naslednji vklop gre samo znova prek .../setup, ki takoj obremeni prvo polnjenje. Po dokončanju Checkouta se brskalnik vrne na ČESKO stran portala (/kredit?karta=zmenena) ne glede na jezik računa - ista znana vrzel kot zgoraj.

Omejitve

Dve NEODVISNI omejitvi: največ 10.000 CZK pripisanega dobroimetja na koledarski mesec in največ 4 polnjenja na KOLEDARSKI DAN - ne glede na to, kolikokrat stanje pade pod prag. Prekoračitev katerekoli samodejno izklopi samodejno polnjenje (disabledReason monthly_cap oziroma daily_cap); spentThisMonthHal/monthlyCapHal v odgovoru kažeta, koliko mesečne omejitve še ostaja.

MCP: get_auto_topup (branje) in disable_auto_topup (izklop) - vklopa, spremembe zneska in kartice v MCP ni, iz istega razloga kot enabled: true v REST zgoraj.

Mesečna omejitev porabe

Neobvezna zaščita pred nepričakovano visokim računom: sami določite, koliko smejo klici, SMS in glasovni agent stati na koledarski mesec (po času v Pragi). Funkcija je vklopljena samo pri računu, ki si je omejitev nastavil; brez nje se nič ne spremeni in poraba meseca se le beleži.

GET /v1/account/spend-cap vrne {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Brez omejitve je enabled: false in polja omejitve so null, monthSpendHal pa dobite vedno. Zneski so v celih stotinkah brez DDV.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} omejitev nastavi ali spremeni: capHal je v celih stotinkah od 5.000 (50 CZK) do 100.000.000 (1.000.000 CZK), warnShare je delež omejitve od 0,5 do 0,99 (privzeto 0,8), pri katerem pride opozorilna e-pošta, in inboundAboveCap: true agentom dovoli še naprej sprejemati dohodne klice tudi nad omejitvijo (privzeto false, pri spremembi brez polja velja shranjena vrednost). DELETE /v1/account/spend-cap omejitev odpravi; odprava neobstoječe omejitve je v redu.

Ko je omejitev dosežena, se novi odhodni klici, preklici, preizkusni klici in SMS zavrnejo s kodo spend_cap_reached (HTTP 402), nič se ne obračuna in ponovitev ne pomaga, dokler se mesec ne konča ali omejitve ne zvišate ali odpravite. Dohodni klic agenta se po eni povedi konča in nič ne stane, razen če je inboundAboveCap: true. E-pošta pride ob doseženem warnShare in ob doseženi omejitvi, vedno največ enkrat na mesec.

Česa omejitev NE ustavi: klicev, ki ravno tečejo (cena se odtegne šele po klicu, zato se lahko mesec konča za njihovo ceno nad omejitvijo, enako kot pri klicih, obračunanih po polnoči), preusmeritev brez agenta ter stroškov za številke, kroga popravkov Na ključ in mesečnega paketa, ki se v omejitev ne štejejo. Pri računu s paketom se v porabo šteje tudi to, kar je krilo mesečno dobroimetje. Številka v lastni SIP centrali z inboundAboveCap: true ostane v SIP proxyju, zato omejitev odhodnih klicev iz centrale ne ustavi.

MCP: get_spend_cap, set_spend_cap in clear_spend_cap kličejo isto storitev kot REST in portal (razdelek Mesečna omejitev porabe v Dobroimetju). set_spend_cap mora stranki znesek ponoviti pred zapisom in po njem.

Mesečni paket

Neobvezna naročnina: vsak mesec se s shranjene kartice obremeni cena izbrane stopnje in pripiše se mesečno dobroimetje v CZK, ki se porablja po običajnem ceniku. Cene in obračun po sekundah se s tem ne spremenijo, paket je plast nad njimi. Stopnje so tri in tier je njihova cena v CZK brez DDV: "490", "990" in "1990"; ceno in dobroimetje vsake stopnje vrne GET /v1/subscription v polju tiers.

Dve vrsti dobroimetja

Mesečno dobroimetje izvira iz paketa, ob koncu obdobja zapade in ni vračljivo. Napolnjeno dobroimetje (polnjenje, pozdravni bonus, popravki) ne poteče in je vračljivo kot doslej. Stanje računa - balanceHal v GET /v1/balance, v portalu in v vseh vratih (minimum za klic, meja dolga, opozorila) - je vsota obeh vrst. Samo napolnjeno dobroimetje je v topupBalanceHal, preostalo mesečno dobroimetje v subscription.monthlyRemainingHal. Dolg lahko nastane samo v napolnjenem dobroimetju.

Vrstni red porabe

Vsaka poraba gre najprej iz mesečnega dobroimetja, ostanek pa iz napolnjenega - klici po sekundah, agent, stroški za številke in mobilne številke, SMS, preklici in odhodne naloge. Delitev je atomarna in zapisana v knjigi gibanj: poraba, krita z mesečnim dobroimetjem, nosi fromSubscriptionHal (del, ki ga je krilo mesečno dobroimetje). Popravki lastnika (admin, tudi negativni) in vračilo za neposlan SMS (refund) se nanašajo samo na napolnjeno dobroimetje.

Obdobje in pripis

Obdobje traja en mesec od uspešne obremenitve (31. 1. da 28. 2.). Mesečno dobroimetje se pripiše šele po potrjenem plačilu z zapisom subscription_grant in pripis je idempotenten glede na id plačila. Če ima račun v tistem trenutku dolg v napolnjenem dobroimetju, se najprej poravna iz novega mesečnega dobroimetja, da napolnjeno dobroimetje ne ostane negativno.

Zapadlost

Neporabljeni ostanek mesečnega dobroimetja zapade na dan obnove (zapis subscription_expire z negativnim zneskom), ob prenehanju naročnine ali z avtomatsko varovalko, ko se je obdobje končalo pred več kot 36 urami brez obnove. Če obremenitev ne uspe, je ostanek že zapadel in novo dobroimetje se ne pripiše; do plačila račun teče samo na napolnjenem dobroimetju.

Izbira po porabi

Ob vklopu se obvezno izbere exhaustionMode, brez privzete vrednosti. topup: po porabi mesečnega dobroimetja se s shranjene kartice doplačuje napolnjeno dobroimetje - to je današnje samodejno polnjenje z enakimi omejitvami in e-pošto. cap (omejitev): nič se ne doplačuje, odhodni klici, SMS in nakupi številk se zavrnejo z napako subscription_cap_reached (HTTP 402), ko pa je stanje pod ničlo, se ustavijo tudi dohodni klici, preusmeritev in dostop SIP (ustavitev pri nič; nadaljuje se po dopolnitvi ali z novim mesečnim dobroimetjem). Z omejitvijo samodejnega polnjenja ni mogoče vklopiti (subscription_cap_active); preklop na omejitev ga izklopi. Največ, kar na mesec z omejitvijo plačate, je cena paketa.

Sprememba stopnje, preklic, obnovitev

Sprememba stopnje (navzgor in navzdol) velja od naslednjega obdobja, brez doplačila. Preklic je cancelAtPeriodEnd: true: dobroimetje velja do konca obdobja, nato zapade in stanje je canceled; do konca obdobja je mogoče preklic umakniti. Prek REST ali MCP ni mogoče zvišati stopnje, obnoviti preklicanega paketa ali preklopiti na doplačevanje s kartice - ti koraki povečajo ali znova vklopijo ponavljajoče obremenjevanje, zato vrnejo subscription_confirmation_required s confirmUrl, ki ga človek odpre in potrdi v portalu (velja 24 ur).

Nasvet pred obnovo

Tri dni pred obnovo (najkasneje dan prej) pride e-pošta, vendar samo če bi vam pri dosedanji porabi prišlo ceneje plačevati po sekundah ali nižja stopnja. Velja isto pravilo kot nasvet v e-pošti o obnovi in v portalu: druga pot mora biti ceneje vsaj za 50 CZK in 5 %. Ocena za celotno obdobje vzame višjo od obeh vrednosti tempa (od začetka obdobja in za zadnjih 7 dni) in ni nikoli nižja od porabe za zadnjih 30 dni, iz katere svetuje portal; vrstici Stopnja in Preklic zato po kliku ne povesta, da stopnja ustreza. E-pošta navede natančen datum in uro obnove in pride največ enkrat na obdobje, nikoli pri paketu, preklicanem ob koncu obdobja, z načrtovano spremembo stopnje, brez shranjene kartice ali ob čakanju na plačilo. Gumb v njej v portalu neposredno odpre vrstico Preklic (/kredit?pausal=zrusit) ali Stopnja (/kredit?pausal=stupen). E-pošta o obnovi nato svetuje znova iz dejanske porabe celotnega obdobja, zato je lahko nasvet drugačen.

Neplačana obnova

Obremenitev s shranjene kartice se poskuša na dan obnove, čez 2 in čez 4 dni. Po prvem neuspehu je stanje past_due, pride e-pošta s povezavo za ročno plačilo in za zamenjavo kartice, mesečno dobroimetje pa je 0; ročno plačilo vrne POST /v1/subscription/pay. Po tretjem neuspehu se paket konča (canceled), napolnjeno dobroimetje in račun delujeta naprej.

DDV in dokumenti

Cene so brez DDV. Režim DDV se prebere pred vsako obremenitvijo, zato zavezanec iz druge države EU s preverjeno davčno številko plača brez češkega DDV (reverse charge) in dokument to odraža. Davčni dokument za vsako plačano obdobje izda volai sam (davčna osnova je cena stopnje, ne pripisano dobroimetje) in ga najdete v GET /v1/billing/documents.

Odnos do bonusa in prvega polnjenja

Vklop paketa se šteje kot prvo plačilo: odklene SMS prek skupnega pošiljatelja, preusmeritve, drugo številko, mobilno številko in kartico samodejnega polnjenja enako kot polnjenje. Pozdravni bonus ostaja napolnjeno dobroimetje.

Vračljivost

Mesečno dobroimetje ni vračljivo in zapade; napolnjeno dobroimetje je vračljivo kot doslej. Preklic paketa ne ustvari pravice do sorazmernega dela plačanega obdobja. Vračilo plačila za paket (reklamacija, pomota) lastnik volai rešuje ročno, prek API-ja ali MCP ni mogoče.

Paket v REST in MCP

Denar se premika samo s človekom ob kartici. Vklop paketa in ročno plačilo vrneta samo povezavo na Stripe Checkout in nikoli ne obremenita kartice neposredno; zvišanje stopnje, obnovitev paketa, nastavljenega na konec obdobja, in preklop na doplačevanje s kartice zahtevajo potrditev prijavljenega človeka v portalu.

• GET /v1/subscription - stanje paketa (subscription ali null), katalog stopenj tiers (id, priceHal, creditHal), topupBalanceHal, available (ali je mogoče vklopiti nov paket: ponudba je vklopljena in noben paket ne teče), recommendation (najcenejša pot za porabo zadnjih 30 dni in steady, ali poraba traja, ne samo kot enkraten vrh; null brez ponudbe ali brez 30 dni zgodovine) in previousPeriod (pretekla doba z istimi števili kot e-pošta o obnovi: usedHal iz creditHal, usedPercent, poraba nad mesečnim dobroimetjem overHal in zapadli ostanek expiredHal; samo pri aktivnem paketu, null v prvem obdobju in kadar porabe ni mogoče izkazati iz zgodovine).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - vrne {checkoutUrl} na Stripe Checkout, po čigar dokončanju paket začne teči. exhaustionMode (topup ali cap) je obvezen; potrošnik brez ID za DDV mora poslati consumerConsent: true (sicer consumer_consent_required). Plačilni naslov mora biti popoln (billing_address_required). Podpira Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - znižanje stopnje, preklic (cancelAtPeriodEnd: true) in preklop na omejitev (exhaustionMode: "cap") izvede in vrne {subscription}. Zvišanje stopnje, obnovitev paketa, nastavljenega na konec obdobja (cancelAtPeriodEnd: false), in exhaustionMode: "topup" nič ne spremenijo in vrnejo 409 subscription_confirmation_required s confirmUrl.
• POST /v1/subscription/pay - samo v stanju past_due; vrne {checkoutUrl} za ročno plačilo obnove. Podpira Idempotency-Key.
• POST /v1/subscription/card - vrne {checkoutUrl} za zamenjavo shranjene kartice paketa, nič se ne obremeni. Podpira Idempotency-Key.
• GET /v1/balance dodatno nosi subscription (ista oblika kot zgoraj, sicer null) in topupBalanceHal.

MCP: get_subscription (branje), create_subscription_link (povezava za vklop), update_subscription in cancel_subscription (znižanje stopnje, preklic, omejitev; zvišanje, obnovitev in doplačevanje vrnejo confirmUrl s stavkom, da mora to potrditi človek v portalu) in create_subscription_payment_link (ročno plačilo). Zamenjave kartice v MCP ni, iz istega razloga kot pri samodejnem polnjenju: od tod se nič ne obremenjuje.

Davčni dokumenti

Dokument nastane samodejno ob polnjenju dobroimetja s kartico (enkratnem in samodejnem), ob plačilu vzpostavitve Na ključ in kot popravni dokument ob vračilu vzpostavitve - brez ročnega koraka, brez izdaje prek API-ja.

GET /v1/billing/documents?limit&before - najnovejši najprej, kazalec before (Unix ms, ekskluziven) je nextBefore s prejšnje strani. Shramba sama nikoli ne vrne več kot 100 zapisov na klic, tudi če limit zahteva več.

GET /v1/billing/documents/{id} vrne {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true pri zavezancih iz druge države EU s preverjeno davčno številko (VIES), ki plačujejo brez češkega DDV. Polje kind je vedno izpolnjeno - "invoice" pri navadnem dokumentu (tudi pri dokumentih, izdanih pred uvedbo polja), "credit_note" pri popravnem davčnem dokumentu - ta nastane samodejno, ko lastnik vrne ceno vzpostavitve pri preklicanem naročilu Na ključ, oštevilčuje se z lastnim nizom OD... in dodatno nosi correctsNumber (številka popravljenega dokumenta) in correctionReason (razlog vračila); zneski netHal/vatHal/grossHal so tudi pri dobropisu POZITIVNI, predznak minus doda šele PDF.

GET /v1/billing/documents/{id}/pdf prenese isti dokument kot application/pdf - sestavi se na novo ob vsakem prenosu, ne shranjuje se. Tuj ali neobstoječ id javlja isto napako (invoice_not_found) v obeh endpointih, da iz odgovora ni mogoče ugotoviti, da tuj dokument obstaja.

MCP: list_billing_documents in get_billing_document imata isto obliko kot REST. PDF je samo v RESTu - MCP nima binarnega kanala za prenos datoteke.

Napake

• ledger_unavailable - Zgodovine gibanj ali stanja trenutno ni mogoče prebrati - poskusite znova čez nekaj trenutkov.
• invalid_amount - Znesek polnjenja, praga ali samodejnega plačila ni ena od ponujenih fiksnih vrednosti.
• billing_address_required - Plačilni naslov manjka ali je nepopoln - dopolnite ga v portalu (/nastaveni) pred polnjenjem, sicer ni mogoče izdati veljavnega dokumenta.
• stripe_not_configured - Plačila so za ta zagon volai izklopljena - ne nanaša se konkretno na vašo zahtevo.
• stripe_error - Stripe je zavrnil ustvarjanje plačilne seje - poskusite znova čez nekaj trenutkov.
• autotopup_not_configured - Samodejno polnjenje še nikoli ni šlo skozi .../setup - ni kaj izklopiti, spremeniti ali katere kartice zamenjati.
• invoice_not_found - Dokumenta s tem id na računu ni (ali pripada drugemu računu - odgovor je enak).
• spend_cap_reached - Mesečna omejitev porabe, ki ste jo nastavili, je dosežena: novi odhodni klici in SMS se zavračajo in nič se ne obračuna. Omejitev zvišate ali odpravite prek PUT ali DELETE /v1/account/spend-cap, sicer velja do konca meseca (do polnoči v Pragi).
• subscription_cap_reached - Omejitev paketa: mesečno in napolnjeno dobroimetje sta porabljena in račun ima izbrano omejitev. Odhodni klici, SMS in nakupi številk se zavračajo (HTTP 402) do naslednje obnove ali do ročnega polnjenja.
• subscription_exists - Račun paket že ima; sprememba stopnje, preklic in izbira po porabi gredo prek PATCH /v1/subscription.
• subscription_missing - Račun nima aktivnega paketa, ki bi ga bilo mogoče spremeniti, preklicati ali ročno plačati.
• subscription_canceled - Paket se je že končal (stanje canceled): ni ga mogoče spremeniti, preklicati ali ročno plačati. Novega vklopite prek POST /v1/subscription/checkout.
• subscription_confirmation_required - Zvišanje stopnje, obnovitev paketa, nastavljenega na konec obdobja, in doplačevanje s kartice potrdi samo človek v portalu - odgovor nosi confirmUrl in nič se ni spremenilo.
• consumer_consent_required - Potrošnik brez ID za DDV mora ob vklopu potrditi izrecno zahtevo za začetek izvajanja pred iztekom roka za odstop (consumerConsent: true).
• pausal_unavailable - Ponudba paketa je za ta račun trenutno izklopljena.
• invalid_tier - Stopnja, ki jo paket že ima, ko ni načrtovana nobena druga (stopnja, na katero že prehaja, ni napaka in se šteje za izvedeno, zato je isti PATCH /v1/subscription po izpadu mogoče poslati znova; izjema je vrnitev na današnjo stopnjo, ki načrtovano spremembo prekliče: ob ponovitvi ni več česa preklicati); neznana vrednost zunaj "490", "990", "1990" se konča kot validation.
• subscription_cap_active - Z omejitvijo samodejnega polnjenja ni mogoče vklopiti; najprej v portalu preklopite izbiro po porabi na topup.
• validation - Pri PATCH /v1/credit/auto-topup konkretno: poskus vklopa (enabled: true) ali neposredne spremembe amountHal - namesto tega uporabite POST .../setup.

Popolno tabelo napak za vsak endpoint najdete v razdelku Dobroimetje v REST API referenci.