Sprievodcovia

Kredit

Zostatok, históriu pohybov a daňové doklady čítate cez API aj MCP. Platba kartou - jednorazová aj automatická - vždy vedie cez odkaz na Stripe Checkout, ktorý dokončí človek; API samo nikdy kartu nestrhne. To isté platí pre voliteľný mesačný paušál.

Peniaze bez DPH, halierov, jazyk popisu

Všetky sumy v tomto API sú celé čísla v HALIEROCH a bez DPH - volai je platiteľ DPH, ale DPH sa počíta až pri dobíjaní kreditu kartou (prehľad na /cenik). Popisy pohybov (GET /v1/credit/ledger) skladá API anglicky z typu pohybu - uložená česká poznámka von nejde nikdy, ani v inom poli.

Zostatok, výdrž a upozornenie

GET /v1/balance vracia aktuálny zostatok plus dva doplnkové výpočty ADITÍVNE (existujúci klienti, ktorí čítajú len balanceHal/balanceCzk/currency, sa nerozbijú): runway (dailyAverageHal - priemerná denná útrata z poslednej doby, runwayDays - koľko dní kredit pri tomto tempe vydrží, null keď sa nedá vypočítať) a notice - rovnaké upozornenie, aké vidíte na /prehled v portáli, null keď žiadne nie je. Osem možných tvarov notice: {kind:"unknown"} (nedostatok dát na odhad), {kind:"empty"} (nulový zostatok), {kind:"number_fee",feeHal,dueAt} (do 3 dní je splatný mesačný poplatok za hlasové alebo mobilné čísla a zostatok naň nestačí; feeHal je súčet všetkých takýchto poplatkov, dueAt najskoršia splatnosť; pri zapnutom automatickom dobíjaní sa nevracia), {kind:"runway",days} (kredit dôjde za days dní pri súčasnom tempe) a štyri tvary len pri účte s mesačným paušálom: {kind:"subscription_exhausted_topup",renewsAt} (mesačný kredit tohto obdobia je vyčerpaný a paušál beží v režime dokupovať, ďalšia útrata ide z dobitého kreditu; renewsAt je koniec obdobia v ms, kedy sa pripíše nový mesačný kredit), {kind:"subscription_cap_reached",renewsAt} (mesačný kredit je vyčerpaný, paušál beží so stropom a dobitý kredit nič nepokryje, platené akcie stoja do renewsAt alebo do ručného dobitia) a {kind:"subscription_past_due"} (obnova paušálu neprešla, uloženú kartu sa nepodarilo strhnúť; obnovu zaplatíte v portáli alebo vymeníte kartu) a {kind:"subscription_runway",renewsAt,runsOutAt} (zostatok dôjde skôr, než sa v renewsAt pripíše nový mesačný kredit; runsOutAt je odhad v ms, kedy dôjde, z opatrného tempa paušálu, rovnakého ako výhľad mesačného kreditu na karte paušálu v portáli: najvyšší z priemeru za 28 dní (len pri úplnej histórii kreditu), priemeru prevádzky za posledných 7 pražských dní bez poplatkov za čísla a priemeru od začiatku obdobia (až po jeho prvom týždni); runway ďalej počíta s priemerom za 28 dní; predplatiteľovi sa vracia namiesto runway a pri zapnutom automatickom dobíjaní sa nevracia). renewsAt je v ms (epoch), teda ten istý okamih ako subscription.periodEnd v rovnakej odpovedi, kde je ISO 8601 reťazec; formát ani jedného poľa sa nemení. Pri paušále zrušenom ku koncu obdobia nesú subscription_exhausted_topup, subscription_cap_reached a subscription_runway navyše cancelAtPeriodEnd: true: žiadna obnova nepríde, renewsAt je koniec paušálu a nový mesačný kredit sa nepripíše (pri strope potom ide pokračovať len dobitím); bez zrušenia pole v upozornení nie je. Pri účte s mesačným paušálom nesie odpoveď navyše subscription (stav paušálu, inak null) a topupBalanceHal (len dobitý kredit); balanceHal zostáva súčtom mesačného a dobitého kreditu, pozrite kapitolu Mesačný paušál.

História pohybov

GET /v1/credit/ledger?limit - najnovšie pohyby prvé, BEZ kurzora (len limit, 1-200, predvolene 50) - staršie pohyby než tých najnovších 200 cez API nedosiahnete, celú históriu má portál /kredit a daňové doklady. Každý záznam nesie type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - kolo úprav objednávky Na kľúč nad rámec balíka, subscription_grant - pripísanie mesačného kreditu z paušálu a subscription_expire - prepadnutie jeho nevyužitého zvyšku), amountHal (kladné pripísanie, záporné odpočítanie), grossHal (suma s DPH pri dobití kartou, inak null) a anglický description zložený z typu - pri number_fee navyše s číslom, ktorého sa poplatok týka. Pri útratách krytých mesačným kreditom je navyše pole fromSubscriptionHal - časť útraty, ktorú pokryl mesačný kredit; pri ostatných pohyboch chýba. Doplnok mobilné číslo sa v histórii ukáže ako number_fee (prvé obdobie pri kúpe aj každá obnova po 30 dňoch) a sms (odoslanie z mobilného čísla, sadzba za segment je v cenníku); keď operátor SMS z mobilného čísla dodatočne odmietne, kredit sa vráti záznamom refund.

Dobitie kartou

POST /v1/credit/topup {amountCzk} vráti {checkoutUrl} - odkaz na Stripe Checkout, ktorý otvorí ČLOVEK v prehliadači. Nič sa nestrhne, kým platbu sám nedokončí. Fakturačná adresa (PUT /v1/account/billing) musí byť kompletná PRED volaním - bez nej sa nedá vystaviť platný daňový doklad (billing_address_required). Podporuje Idempotency-Key - bezpečne zopakovateľné po timeoute, bez toho aby vznikli dve platby.

Automatické dobíjanie

Cez API sa automatické dobíjanie dá len ČÍTAŤ, VYPNÚŤ a zmeniť PRAH - zapnutie a zmena SUMY ide výhradne cez Stripe Checkout, nikdy priamym zápisom.

Čítanie a vypnutie

GET /v1/credit/auto-topup vracia {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - BEZ čísla karty, len značka a posledné štyri číslice. PATCH {enabled: false} vypne okamžite, PATCH {thresholdHal} zmení len prah (musí byť z ponúkanej rady a nižší než uložená suma, inak by zostatok po dobití hneď znova klesol pod prah).

Zapnutie a zmena sumy

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} vráti {checkoutUrl} - po dokončení Checkoutu sa OKAMŽITE strhne amountHal ako prvé dobitie a až tým sa uloží karta pre budúce automatické dobitia. Funguje aj s kartou už uloženou z minulosti - je to jediná cesta, ako automatické dobíjanie zapnúť alebo mu zmeniť sumu. Po dokončení Checkoutu sa prehliadač vráti na ČESKÚ stránku portálu (/kredit?automat=zapnuto) aj anglicky hovoriacemu zákazníkovi - známa medzera, nie chyba Vašej integrácie.

Karta

POST /v1/credit/auto-topup/card vráti odkaz na Checkout (režim výmeny karty, nič sa nestrhne) na výmenu uloženej karty. DELETE /v1/credit/auto-topup/card odpojí kartu OKAMŽITE - zmaže sa celá konfigurácia (prah aj suma), nielen karta; ďalšie zapnutie ide len znova cez .../setup, ktorý rovno strhne prvé dobitie. Po dokončení Checkoutu sa prehliadač vráti na ČESKÚ stránku portálu (/kredit?karta=zmenena) bez ohľadu na jazyk účtu - rovnaká známa medzera ako vyššie.

Stropy

Dva NEZÁVISLÉ stropy: najviac 10 000 CZK pripísaného kreditu za kalendárny mesiac a najviac 4 dobitia za KALENDÁRNY DEŇ - bez ohľadu na to, koľkokrát prah klesne pod hranicu. Prekročenie ktoréhokoľvek automatické dobíjanie samo vypne (disabledReason monthly_cap, respektíve daily_cap); spentThisMonthHal/monthlyCapHal v odpovedi ukazujú, koľko z mesačného stropu zostáva.

MCP: get_auto_topup (čítanie) a disable_auto_topup (vypnutie) - zapnutie, zmena sumy ani karta v MCP nie sú, z rovnakého dôvodu ako enabled: true v REST vyššie.

Mesačný strop útraty

Voliteľná poistka proti nečakane vysokému účtu: sami si nastavíte, koľko smú hovory, SMS a hlasový agent stáť za kalendárny mesiac (podľa času v Prahe). Funkcia je zapnutá len pri účte, ktorý si strop nastavil; bez neho sa nič nemení a útrata mesiaca sa len počíta.

GET /v1/account/spend-cap vracia {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Bez stropu je enabled: false a polia stropu sú null, monthSpendHal však dostanete vždy. Sumy sú v celých halieroch bez DPH.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} strop nastaví alebo zmení: capHal je v celých halieroch od 5 000 (50 CZK) do 100 000 000 (1 000 000 CZK), warnShare je podiel stropu od 0,5 do 0,99 (predvolene 0,8), pri ktorom príde varovný e-mail, a inboundAboveCap: true nechá agentov ďalej prijímať prichádzajúce hovory aj nad stropom (predvolene false, pri zmene bez poľa platí uložená hodnota). DELETE /v1/account/spend-cap strop zruší; zrušenie neexistujúceho stropu je v poriadku.

Po dosiahnutí stropu sa nové odchádzajúce hovory, prezvonenia, skúšobné hovory a SMS odmietnu kódom spend_cap_reached (HTTP 402), nič sa neúčtuje a opakovanie nepomôže, kým mesiac neskončí alebo strop nezvýšite či nezrušíte. Prichádzajúci hovor agenta po jednej vete skončí a nič nestojí, ak nie je inboundAboveCap: true. E-mail príde pri dosiahnutí warnShare a pri dosiahnutí stropu, vždy najviac raz za mesiac.

Čo strop NEzastaví: hovory, ktoré práve bežia (cena sa strháva až po hovore, mesiac preto môže skončiť o ich cenu nad stropom, rovnako ako pri hovoroch zaúčtovaných po polnoci), presmerovania bez agenta a poplatky za čísla, kolo úprav Na kľúč a mesačný paušál, ktoré sa do stropu nepočítajú. Pri účte s paušálom sa do útraty počíta aj to, čo pokryl mesačný kredit. Číslo vo Vlastnej SIP ústredni s inboundAboveCap: true zostáva v SIP proxy, takže strop nezastaví odchádzajúce hovory z ústredne.

MCP: get_spend_cap, set_spend_cap a clear_spend_cap volajú rovnakú službu ako REST a portál (sekcia Mesačný strop útraty v Kredite). set_spend_cap má zákazníkovi sumu zopakovať pred zápisom aj po ňom.

Mesačný paušál

Voliteľné predplatné: každý mesiac sa z uloženej karty strhne cena zvoleného stupňa a pripíše sa mesačný kredit v CZK, ktorý sa míňa podľa bežného cenníka. Sadzby ani účtovanie po sekundách sa tým nemenia, paušál je vrstva nad nimi. Stupne sú tri a tier je ich cena v CZK bez DPH: "490", "990" a "1990"; ceny a kredit každého stupňa vracia GET /v1/subscription v poli tiers.

Dva druhy kreditu

Mesačný kredit pochádza z paušálu, na konci obdobia prepadá a je nevratný. Dobitý kredit (dobitie, uvítací bonus, korekcia) nevyprší a je vratný ako doteraz. Zostatok účtu - balanceHal v GET /v1/balance, v portáli aj vo všetkých bránach (minimum pre hovor, limit dlhu, varovania) - je súčet oboch druhov. Samotný dobitý kredit je v topupBalanceHal, zostávajúci mesačný kredit v subscription.monthlyRemainingHal. Dlh môže vzniknúť len v dobitom kredite.

Poradie útraty

Každá útrata ide najprv z mesačného kreditu a zvyšok z dobitého - hovory po sekundách, agent, poplatky za čísla a mobilné čísla, SMS, prezvonenia aj odchádzajúce úlohy. Rozdelenie je atomické a zapísané v ledgeri: útrata krytá mesačným kreditom nesie fromSubscriptionHal (časť, ktorú pokryl mesačný kredit). Korekcie majiteľa (admin, aj záporná) a vrátenie za neodoslanú SMS (refund) sa týkajú len dobitého kreditu.

Obdobie a pripísanie

Obdobie trvá jeden mesiac od úspešného stiahnutia (31. 1. dáva 28. 2.). Mesačný kredit sa pripíše až po potvrdenej platbe záznamom subscription_grant a pripísanie je idempotentné podľa id platby. Ak má účet v tej chvíli dlh v dobitom kredite, uhradí sa najprv z nového mesačného kreditu, aby dobitý kredit nezostal záporný.

Prepadnutie

Nevyužitý zvyšok mesačného kreditu prepadá v deň obnovy (záznam subscription_expire so zápornou sumou), pri skončení predplatného, alebo automatickou poistkou, keď obdobie skončilo pred viac ako 36 hodinami bez obnovy. Ak stiahnutie neprejde, zvyšok už prepadol a nový kredit sa nepripíše; do zaplatenia beží účet len na dobitom kredite.

Voľba po vyčerpaní

Pri zapnutí sa povinne volí exhaustionMode, bez predvoľby. topup: po vyčerpaní mesačného kreditu sa z uloženej karty dokupuje dobitý kredit - je to dnešné automatické dobíjanie s rovnakými limitmi a e-mailmi. cap (strop): nič sa nedokupuje, odchádzajúce hovory, SMS a nákupy čísel sa odmietnu chybou subscription_cap_reached (HTTP 402) a pri zostatku pod nulou sa zastavia aj prichádzajúce hovory, presmerovanie a prístup cez SIP (stop pri nule, obnoví sa po dobití alebo s novým mesačným kreditom). So stropom sa nedá zapnúť automatické dobíjanie (subscription_cap_active); prepnutie na strop ho vypne. Najviac, čo za mesiac so stropom zaplatíte, je cena paušálu.

Zmena stupňa, zrušenie, obnovenie

Zmena stupňa (hore aj dole) platí od ďalšieho obdobia, bez dorovnania. Zrušenie je cancelAtPeriodEnd: true: kredit platí do konca obdobia, potom prepadne a stav je canceled; do konca obdobia sa dá zrušenie vziať späť. Cez REST ani MCP sa nedá zvýšiť stupeň, obnoviť zrušený paušál ani prepnúť na dokupovanie z karty - tieto kroky zvyšujú alebo znova zapínajú opakované strhávanie, preto vrátia subscription_confirmation_required s confirmUrl, ktorý človek otvorí a potvrdí v portáli (platí 24 hodín).

Rada pred obnovou

Tri dni pred obnovou (najneskôr deň vopred) príde e-mail, ale len keď by Vám pri doterajšej útrate vyšlo lacnejšie platiť po sekundách alebo nižší stupeň. Platí rovnaké pravidlo ako rada v e-maile o obnove a v portáli: iná cesta musí vyjsť aspoň o 50 CZK a 5 % lacnejšie. Odhad na celé obdobie berie vyššie z temp od začiatku obdobia a za posledných 7 dní a nikdy nie je nižší než útrata za posledných 30 dní, z ktorej radí portál; riadky Stupeň a Zrušenie preto po kliknutí nepovedia, že stupeň sedí. E-mail uvedie presný dátum a čas obnovy a príde najviac raz za obdobie, nikdy pri paušále zrušenom ku koncu obdobia, s naplánovanou zmenou stupňa, bez uloženej karty ani čakajúcom na platbu. Tlačidlo v ňom otvorí v portáli rovno riadok Zrušenie (/kredit?pausal=zrusit) alebo Stupeň (/kredit?pausal=stupen). E-mail o obnove potom radí znova zo skutočnej útraty celého obdobia, takže rada môže vyjsť aj inak.

Nezaplatená obnova

Stiahnutie z uloženej karty sa skúša v deň obnovy, o 2 a o 4 dni. Po prvom neúspechu je stav past_due, príde e-mail s odkazom na ručnú platbu a na zmenu karty a mesačný kredit je 0; ručnú platbu vracia POST /v1/subscription/pay. Po treťom neúspechu paušál skončí (canceled), dobitý kredit a účet fungujú ďalej.

DPH a doklady

Ceny sú bez DPH. Režim DPH sa číta pred každým stiahnutím, takže platiteľ z iného štátu EÚ s overeným DIČ platí bez českej DPH (reverse charge) a doklad to odráža. Daňový doklad za každé zaplatené obdobie vystavuje volai sám (základ dane je cena stupňa, nie pripísaný kredit) a nájdete ho v GET /v1/billing/documents.

Vzťah k bonusu a prvému dobitiu

Zapnutie paušálu sa počíta ako prvá platba: odomyká SMS zo zdieľaného odosielateľa, presmerovanie, druhé číslo, mobilné číslo aj kartu automatického dobíjania rovnako ako dobitie. Uvítací bonus zostáva dobitým kreditom.

Vratnosť

Mesačný kredit je nevratný a prepadá; dobitý kredit je vratný ako doteraz. Zrušenie paušálu nezakladá nárok na pomernú časť zaplateného obdobia. Vrátenie platby za paušál (reklamácia, omyl) rieši majiteľ volai ručne, cez API ani MCP nejde.

Paušál v REST a MCP

Peniaze sa hýbu len s človekom pri karte. Zapnutie paušálu a ručná platba vracajú len odkaz na Stripe Checkout a nikdy nestrhnú kartu priamo; zvýšenie stupňa, obnovenie paušálu nastaveného ku koncu obdobia a prepnutie na dokupovanie z karty vyžadujú potvrdenie prihláseného človeka v portáli.

• GET /v1/subscription - stav paušálu (subscription alebo null), katalóg stupňov tiers (id, priceHal, creditHal), topupBalanceHal, available (dá sa zapnúť nový paušál: ponuka je zapnutá a žiadny paušál nebeží), recommendation (najlacnejšia cesta pre útratu za posledných 30 dní a steady, či útrata trvá, nie len jednorazová špička; null bez ponuky alebo bez 30 dní histórie) a previousPeriod (minulé obdobie s rovnakými číslami ako e-mail o obnove: usedHal z creditHal, usedPercent, útrata nad mesačný kredit overHal a prepadnutý zvyšok expiredHal; len pri aktívnom paušále, null v prvom období a keď sa útrata z histórie nedá doložiť).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - vráti {checkoutUrl} na Stripe Checkout, po jeho dokončení paušál začne. exhaustionMode (topup alebo cap) je povinný; spotrebiteľ bez IČO musí poslať consumerConsent: true (inak consumer_consent_required). Fakturačná adresa musí byť kompletná (billing_address_required). Podporuje Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - zníženie stupňa, zrušenie (cancelAtPeriodEnd: true) a prepnutie na strop (exhaustionMode: "cap") vykoná a vráti {subscription}. Zvýšenie stupňa, obnovenie paušálu nastaveného ku koncu obdobia (cancelAtPeriodEnd: false) a exhaustionMode: "topup" nič nezmenia a vrátia 409 subscription_confirmation_required s confirmUrl.
• POST /v1/subscription/pay - len v stave past_due; vráti {checkoutUrl} na ručné zaplatenie obnovy. Podporuje Idempotency-Key.
• POST /v1/subscription/card - vráti {checkoutUrl} na výmenu uloženej karty paušálu, nič sa nestrhne. Podporuje Idempotency-Key.
• GET /v1/balance nesie navyše subscription (rovnaký tvar ako vyššie, inak null) a topupBalanceHal.

MCP: get_subscription (čítanie), create_subscription_link (odkaz na zapnutie), update_subscription a cancel_subscription (zníženie stupňa, zrušenie, strop; zvýšenie, obnovenie a dokupovanie vrátia confirmUrl s vetou, že to musí potvrdiť človek v portáli) a create_subscription_payment_link (ručná platba). Výmena karty v MCP nie je, z rovnakého dôvodu ako pri automatickom dobíjaní: odtiaľto sa nič nestrháva.

Daňové doklady

Doklad vzniká automaticky pri dobití kreditu kartou (jednorazovom aj automatickom), pri zaplatení zriadenia Na kľúč a ako opravný doklad pri vrátení zriadenia - žiadny ručný krok, žiadne vystavenie cez API.

GET /v1/billing/documents?limit&before - najnovšie prvé, kurzor before (Unix ms, exkluzívny) je nextBefore z predchádzajúcej stránky. Úložisko samo nikdy nevráti viac ako 100 záznamov na jedno volanie, aj keď limit požaduje viac.

GET /v1/billing/documents/{id} vracia {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true pri platiteľoch z iného štátu EÚ s overeným DIČ (VIES), ktorí platia bez českej DPH. Pole kind je vždy vyplnené - "invoice" pri bežnom doklade (aj pri dokladoch vystavených pred zavedením poľa), "credit_note" pri opravnom daňovom doklade - ten vzniká automaticky, keď majiteľ vráti cenu zriadenia pri zrušenej objednávke Na kľúč, čísluje sa vlastným číselným radom OD... a nesie navyše correctsNumber (číslo opravovaného dokladu) a correctionReason (dôvod vrátenia); sumy netHal/vatHal/grossHal sú aj pri dobropise KLADNÉ, znamienko mínus dáva až PDF.

GET /v1/billing/documents/{id}/pdf stiahne ten istý doklad ako application/pdf - generuje sa nanovo pri každom stiahnutí, neukladá sa. Cudzie alebo neexistujúce id hlási rovnakú chybu (invoice_not_found) v oboch endpointoch, aby sa z odpovede nedalo poznať, že cudzí doklad existuje.

MCP: list_billing_documents a get_billing_document majú rovnaký tvar ako REST. PDF je len REST - MCP nemá binárny kanál na prenos súboru.

Chyby

• ledger_unavailable - Históriu pohybov ani zostatok sa momentálne nedarí prečítať - skúste to znova o chvíľu.
• invalid_amount - Suma dobitia, prahu alebo automatickej platby nie je jedna z ponúkaných pevných hodnôt.
• billing_address_required - Fakturačná adresa chýba alebo je neúplná - doplňte ju v portáli (/nastaveni) pred dobitím, inak sa nedá vystaviť platný doklad.
• stripe_not_configured - Platby sú pre toto prostredie volai vypnuté - netýka sa konkrétne Vašej požiadavky.
• stripe_error - Stripe odmietol vytvoriť platobnú reláciu - skúste to znova o chvíľu.
• autotopup_not_configured - Automatické dobíjanie ešte nikdy neprešlo .../setup - nie je čo vypnúť, zmeniť ani akú kartu vymeniť.
• invoice_not_found - Doklad s týmto id na účte nie je (alebo patrí inému účtu - odpoveď je rovnaká).
• spend_cap_reached - Mesačný strop útraty, ktorý ste si nastavili, je dosiahnutý: nové odchádzajúce hovory a SMS sa odmietajú a nič sa neúčtuje. Strop zvýšite alebo zrušíte cez PUT alebo DELETE /v1/account/spend-cap, inak platí do konca mesiaca (do polnoci v Prahe).
• subscription_cap_reached - Strop paušálu: mesačný aj dobitý kredit je vyčerpaný a účet má zvolený strop. Odchádzajúce hovory, SMS a nákupy čísel sa odmietajú (HTTP 402) do ďalšej obnovy alebo do ručného dobitia.
• subscription_exists - Účet už paušál má; zmena stupňa, zrušenie a voľba po vyčerpaní idú cez PATCH /v1/subscription.
• subscription_missing - Účet nemá aktívny paušál, ktorý by sa dal zmeniť, zrušiť alebo zaplatiť ručne.
• subscription_canceled - Paušál už skončil (stav canceled): nedá sa zmeniť, zrušiť ani zaplatiť ručne. Nový zapnete cez POST /v1/subscription/checkout.
• subscription_confirmation_required - Zvýšenie stupňa, obnovenie paušálu nastaveného ku koncu obdobia a dokupovanie z karty potvrdí len človek v portáli - odpoveď nesie confirmUrl a nič sa nezmenilo.
• consumer_consent_required - Spotrebiteľ bez IČO musí pri zapnutí potvrdiť výslovnú žiadosť o začatie plnenia pred uplynutím lehoty na odstúpenie (consumerConsent: true).
• pausal_unavailable - Ponuka paušálu je pre tento účet práve vypnutá.
• invalid_tier - Stupeň, ktorý už paušál má, keď nie je naplánovaný žiadny iný (stupeň, na ktorý už prechádza, chyba nie je a berie sa ako vykonaný, takže rovnaké PATCH /v1/subscription je možné po výpadku poslať znova; výnimkou je návrat na dnešný stupeň, ktorý naplánovanú zmenu ruší: pri opakovaní už nie je čo rušiť); neznáma hodnota mimo "490", "990", "1990" skončí ako validation.
• subscription_cap_active - So stropom sa nedá zapnúť automatické dobíjanie; najprv prepnite voľbu po vyčerpaní na topup v portáli.
• validation - Pri PATCH /v1/credit/auto-topup konkrétne: pokus zapnúť (enabled: true) alebo zmeniť amountHal priamo - použite namiesto toho POST .../setup.

Úplnú tabuľku chýb pre každý endpoint nájdete v sekcii Kredit v REST API referencii.