Guides

Saldo

Saldo, bevægelseshistorik og skattedokumenter kan du læse via både API og MCP. Betaling med kort - både engangsbetaling og automatisk - går altid via et link til Stripe Checkout, som et menneske gennemfører; API'et trækker aldrig selv på kortet. Det samme gælder det valgfrie månedlige abonnement.

Penge uden moms, heller, beskrivelsens sprog

Alle beløb i dette API er hele tal i HELLERE (1/100 CZK) og uden moms - volai er momsregistreret, men momsen beregnes først, når saldoen fyldes op med kort (oversigt på /cenik). Beskrivelserne af bevægelserne (GET /v1/credit/ledger) sammensætter API'et på engelsk ud fra bevægelsens type - en gemt tjekkisk note sendes aldrig ud, heller ikke i et andet felt.

Saldo, rækkevidde og advarsler

GET /v1/balance returnerer den aktuelle saldo plus to supplerende beregninger ADDITIVT (eksisterende klienter, der kun læser balanceHal/balanceCzk/currency, går ikke i stykker): runway (dailyAverageHal - det gennemsnitlige daglige forbrug på det seneste, runwayDays - hvor mange dage saldoen holder i dette tempo, null, når det ikke kan beregnes) og notice - den samme advarsel, som du ser på /prehled i portalen, null, når der ingen er. Otte mulige former af notice: {kind:"unknown"} (for få data til et skøn), {kind:"empty"} (nul i saldo), {kind:"number_fee",feeHal,dueAt} (inden for 3 dage forfalder det månedlige gebyr for stemme- eller mobilnumre, og saldoen rækker ikke til det; feeHal er summen af alle sådanne gebyrer, dueAt den tidligste forfaldsdato; returneres ikke ved aktiveret automatisk optankning), {kind:"runway",days} (saldoen slipper op om days dage i det nuværende tempo) og fire former kun for en konto med månedligt abonnement: {kind:"subscription_exhausted_topup",renewsAt} (den månedlige saldo for denne periode er brugt op, og abonnementet kører i tilstanden køb mere, yderligere forbrug går fra den optankede saldo; renewsAt er periodens slutning i ms, hvor en ny månedlig saldo bliver indsat), {kind:"subscription_cap_reached",renewsAt} (den månedlige saldo er brugt op, abonnementet kører med loft, og optanket saldo dækker intet, betalte handlinger er spærret indtil renewsAt eller manuel optankning) og {kind:"subscription_past_due"} (fornyelsen af abonnementet gik ikke igennem, det gemte kort kunne ikke belastes; du betaler fornyelsen i portalen eller skifter kort) og {kind:"subscription_runway",renewsAt,runsOutAt} (saldoen slipper op, før en ny månedlig saldo indsættes på renewsAt; runsOutAt er et skøn i ms for, hvornår den slipper op, ud fra abonnementets forsigtige tempo, det samme som udsigten for den månedlige saldo på abonnementskortet i portalen: det højeste af gennemsnittet over 28 dage (kun ved fuld saldohistorik), gennemsnittet af driften de seneste 7 dage efter Pragtid uden gebyrer for numre og gennemsnittet fra periodens begyndelse (først efter dens første uge); runway regner fortsat med gennemsnittet over 28 dage; for en abonnent returneres den i stedet for runway, og ved aktiveret automatisk optankning returneres den ikke). renewsAt er i ms (epoch), altså det samme tidspunkt som subscription.periodEnd i det samme svar, hvor det er en ISO 8601-streng; formatet af ingen af felterne ændres. Ved et abonnement, der er opsagt til periodens udløb, har subscription_exhausted_topup, subscription_cap_reached og subscription_runway desuden cancelAtPeriodEnd: true: der kommer ingen fornyelse, renewsAt er abonnementets slutning, og en ny månedlig saldo indsættes ikke (ved loftet kan man så kun fortsætte med optankning); uden opsigelse er feltet ikke i advarslen. Ved en konto med månedligt abonnement har svaret desuden subscription (abonnementets tilstand, ellers null) og topupBalanceHal (kun optanket saldo); balanceHal er fortsat summen af månedlig og optanket saldo, se kapitlet Månedligt abonnement.

Bevægelseshistorik

GET /v1/credit/ledger?limit - de nyeste bevægelser først, UDEN markør (kun limit, 1-200, standard 50) - bevægelser ældre end de nyeste 200 når du ikke via API'et, hele historikken har portalen /kredit og skattedokumenterne. Hver post har type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - en rettelsesrunde i en Nøglefærdig-bestilling ud over pakken, subscription_grant - indsættelse af månedlig saldo fra abonnementet og subscription_expire - bortfald af dens ubrugte rest), amountHal (positivt tillæg, negativt fradrag), grossHal (beløbet inkl. moms ved optankning med kort, ellers null) og en engelsk description sammensat ud fra typen - ved number_fee desuden med det nummer, gebyret vedrører. Ved forbrug dækket af månedlig saldo er der desuden feltet fromSubscriptionHal - den del af forbruget, som den månedlige saldo dækkede; ved andre bevægelser mangler det. Tilvalget mobilnummer vises i historikken som number_fee (første periode ved køb og hver fornyelse efter 30 dage) og sms (afsendelse fra mobilnummeret, satsen pr. segment står i prislisten); når operatøren efterfølgende afviser en SMS fra mobilnummeret, refunderes saldoen med en post refund.

Optankning med kort

POST /v1/credit/topup {amountCzk} returnerer {checkoutUrl} - et Stripe Checkout-link, som et MENNESKE åbner i browseren. Intet trækkes, før vedkommende selv gennemfører betalingen. Faktureringsadressen (PUT /v1/account/billing) skal være komplet FØR kaldet - uden den kan der ikke udstedes et gyldigt skattedokument (billing_address_required). Understøtter Idempotency-Key - det er sikkert at gentage efter en timeout, uden at der opstår to betalinger.

Automatisk optankning

Via API'et kan automatisk optankning kun LÆSES, SLÅS FRA og have sin TÆRSKEL ændret - aktivering og ændring af BELØBET sker udelukkende via Stripe Checkout, aldrig ved direkte skrivning.

Læsning og fravalg

GET /v1/credit/auto-topup returnerer {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - UDEN kortnummer, kun mærke og de sidste fire cifre. PATCH {enabled: false} slår fra med det samme, PATCH {thresholdHal} ændrer kun tærsklen (den skal være fra den tilbudte række og lavere end det gemte beløb, ellers falder saldoen straks under tærsklen igen efter optankningen).

Aktivering og ændring af beløbet

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} returnerer {checkoutUrl} - når Checkout er gennemført, trækkes amountHal STRAKS som den første optankning, og først dermed gemmes kortet til fremtidige automatiske optankninger. Virker også med et kort, der allerede er gemt fra tidligere - det er den eneste vej til at aktivere automatisk optankning eller ændre dens beløb. Når Checkout er gennemført, vender browseren tilbage til den TJEKKISKE side i portalen (/kredit?automat=zapnuto), også for en engelsktalende kunde - et kendt hul, ikke en fejl i din integration.

Kort

POST /v1/credit/auto-topup/card returnerer et Checkout-link (kortskifttilstand, intet trækkes) til udskiftning af det gemte kort. DELETE /v1/credit/auto-topup/card frakobler kortet STRAKS - hele konfigurationen slettes (både tærskel og beløb), ikke kun kortet; næste aktivering går kun via .../setup igen, som straks trækker den første optankning. Når Checkout er gennemført, vender browseren tilbage til den TJEKKISKE side i portalen (/kredit?karta=zmenena) uanset kontoens sprog - det samme kendte hul som ovenfor.

Lofter

To UAFHÆNGIGE lofter: højst 10.000 CZK indsat saldo pr. kalendermåned og højst 4 optankninger pr. KALENDERDAG - uanset hvor mange gange tærsklen underskrides. Overskrides et af dem, slår den automatiske optankning sig selv fra (disabledReason monthly_cap hhv. daily_cap); spentThisMonthHal/monthlyCapHal i svaret viser, hvor meget der er tilbage af det månedlige loft.

MCP: get_auto_topup (læsning) og disable_auto_topup (fravalg) - aktivering, ændring af beløbet og kort findes ikke i MCP, af samme grund som enabled: true i REST ovenfor.

Månedligt forbrugsloft

En valgfri sikring mod en uventet høj regning: du bestemmer selv, hvor meget opkald, SMS og stemmeagent må koste pr. kalendermåned (efter Pragtid). Funktionen er kun slået til på en konto, der har sat et loft; uden det ændres intet, og månedens forbrug bliver blot talt op.

GET /v1/account/spend-cap returnerer {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Uden loft er enabled: false, og loftsfelterne er null, men monthSpendHal får du altid. Beløbene er i hele heller uden moms.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} sætter eller ændrer loftet: capHal er i hele heller fra 5 000 (50 CZK) til 100 000 000 (1 000 000 CZK), warnShare er den andel af loftet fra 0,5 til 0,99 (standard 0,8), hvor der kommer en advarselsmail, og inboundAboveCap: true lader agenterne fortsat tage imod indgående opkald, også over loftet (standard false, ved en ændring uden feltet gælder den gemte værdi). DELETE /v1/account/spend-cap ophæver loftet; at ophæve et ikke-eksisterende loft er i orden.

Når loftet er nået, afvises nye udgående opkald, gate-ring, testopkald og SMS med koden spend_cap_reached (HTTP 402), intet afregnes, og et nyt forsøg hjælper ikke, før måneden er slut, eller du hæver eller ophæver loftet. Et indgående agentopkald slutter efter én sætning og koster intet, medmindre inboundAboveCap: true. E-mailen kommer, når warnShare nås, og når loftet nås, altid højst én gang pr. måned.

Hvad loftet IKKE stopper: opkald, der kører lige nu (prisen trækkes først efter opkaldet, måneden kan derfor ende over loftet med deres pris, ligesom ved opkald, der bogføres efter midnat), omstilling uden agent og gebyrer for numre, rettelsesrunden i Nøglefærdig og det månedlige abonnement, som ikke tæller med i loftet. Ved en konto med abonnement tæller det også med i forbruget, som den månedlige saldo dækkede. Et nummer i Egen SIP-omstilling med inboundAboveCap: true forbliver i SIP-proxyen, så loftet stopper ikke udgående opkald fra omstillingen.

MCP: get_spend_cap, set_spend_cap og clear_spend_cap kalder den samme tjeneste som REST og portalen (afsnittet Månedligt forbrugsloft under Saldo). set_spend_cap skal gentage beløbet for kunden både før og efter skrivningen.

Månedligt abonnement

Et valgfrit abonnement: hver måned trækkes prisen for det valgte trin fra det gemte kort, og en månedlig saldo i CZK indsættes, som bruges efter den almindelige prisliste. Satserne og afregningen pr. sekund ændres ikke, abonnementet er et lag oven på dem. Der er tre trin, og tier er deres pris i CZK uden moms: "490", "990" og "1990"; priser og saldo for hvert trin returnerer GET /v1/subscription i feltet tiers.

To slags saldo

Månedlig saldo stammer fra abonnementet, bortfalder ved periodens slutning og kan ikke refunderes. Optanket saldo (optankning, velkomstbonus, korrektion) udløber ikke og kan refunderes som hidtil. Kontoens saldo - balanceHal i GET /v1/balance, i portalen og i alle spærringer (minimum for opkald, gældsgrænse, advarsler) - er summen af begge slags. Den optankede saldo alene er i topupBalanceHal, den resterende månedlige saldo i subscription.monthlyRemainingHal. Gæld kan kun opstå i den optankede saldo.

Rækkefølgen for forbrug

Hvert forbrug går først fra den månedlige saldo og resten fra den optankede - opkald pr. sekund, agent, gebyrer for numre og mobilnumre, SMS, gate-ring og udgående opgaver. Fordelingen er atomisk og skrevet i kontobogen: et forbrug dækket af månedlig saldo har fromSubscriptionHal (den del, som den månedlige saldo dækkede). Ejerens korrektioner (admin, også negative) og refusion for en ikke afsendt SMS (refund) vedrører kun den optankede saldo.

Perioden og indsættelsen

Perioden varer en måned fra den vellykkede betaling (31. 1. giver 28. 2.). Den månedlige saldo indsættes først efter en bekræftet betaling med posten subscription_grant, og indsættelsen er idempotent efter betalingens id. Har kontoen på det tidspunkt gæld i den optankede saldo, dækkes den først af den nye månedlige saldo, så den optankede saldo ikke bliver negativ.

Bortfald

Den ubrugte rest af den månedlige saldo bortfalder på fornyelsesdagen (posten subscription_expire med et negativt beløb), når abonnementet ophører, eller ved en automatisk sikring, når perioden sluttede for mere end 36 timer siden uden fornyelse. Går trækket ikke igennem, er resten allerede bortfaldet, og der indsættes ingen ny saldo; indtil betalingen kører kontoen kun på den optankede saldo.

Valget efter opbrugt saldo

Ved aktivering skal exhaustionMode vælges, uden forvalg. topup: når den månedlige saldo er brugt op, købes optanket saldo fra det gemte kort - det er den nuværende automatiske optankning med de samme grænser og e-mails. cap (loft): intet købes, udgående opkald, SMS og køb af numre afvises med fejlen subscription_cap_reached (HTTP 402), og når saldoen kommer under nul, stopper også indgående opkald, viderestilling og SIP-adgang (stop ved nul; genoptages efter påfyldning eller med den nye månedlige saldo). Med loft kan automatisk optankning ikke aktiveres (subscription_cap_active); skift til loft slår den fra. Det meste, du betaler om måneden med loft, er prisen på abonnementet.

Skift af trin, opsigelse, genoptagelse

Skift af trin (op og ned) gælder fra den næste periode, uden udligning. Opsigelse er cancelAtPeriodEnd: true: saldoen gælder til periodens slutning, derefter bortfalder den, og tilstanden er canceled; frem til periodens slutning kan opsigelsen fortrydes. Via REST og MCP kan man ikke hæve trinnet, genoptage et opsagt abonnement eller skifte til køb fra kortet - disse trin hæver eller genaktiverer tilbagevendende træk, og derfor returnerer de subscription_confirmation_required med et confirmUrl, som et menneske åbner og bekræfter i portalen (gælder i 24 timer).

Råd før fornyelsen

Tre dage før fornyelsen (senest dagen før) kommer en e-mail, men kun hvis det ved dit hidtidige forbrug ville blive billigere at betale pr. sekund eller på et lavere trin. Det samme gælder som for rådet i e-mailen om fornyelsen og i portalen: en anden vej skal blive mindst 50 CZK og 5 % billigere. Skønnet for hele perioden tager det højeste af tempoerne fra periodens begyndelse og fra de seneste 7 dage og er aldrig lavere end forbruget de seneste 30 dage, som portalen rådgiver ud fra; rækkerne Trin og Opsigelse siger derfor efter et klik ikke, at trinnet passer. E-mailen angiver den nøjagtige dato og tid for fornyelsen og kommer højst én gang pr. periode, aldrig ved et abonnement opsagt til periodens udløb, med en planlagt ændring af trinnet, uden gemt kort eller ventende på betaling. Knappen i den åbner i portalen direkte rækken Opsigelse (/kredit?pausal=zrusit) eller Trin (/kredit?pausal=stupen). E-mailen om fornyelsen rådgiver derefter igen ud fra det faktiske forbrug i hele perioden, så rådet kan blive et andet.

Ubetalt fornyelse

Trækket fra det gemte kort forsøges på fornyelsesdagen, efter 2 og efter 4 dage. Efter det første mislykkede forsøg er tilstanden past_due, der kommer en e-mail med et link til manuel betaling og til skift af kort, og den månedlige saldo er 0; den manuelle betaling returnerer POST /v1/subscription/pay. Efter det tredje mislykkede forsøg ophører abonnementet (canceled), den optankede saldo og kontoen fungerer videre.

Moms og dokumenter

Priserne er uden moms. Momsordningen læses før hvert træk, så en momspligtig fra en anden EU-stat med verificeret momsnummer betaler uden tjekkisk moms (reverse charge), og dokumentet afspejler det. Skattedokumentet for hver betalt periode udsteder volai selv (beskatningsgrundlaget er trinnets pris, ikke den indsatte saldo), og du finder det i GET /v1/billing/documents.

Forhold til bonus og første optankning

Aktivering af abonnementet tæller som den første betaling: den låser SMS fra den delte afsender, omstilling, andet nummer, mobilnummer og kortet til automatisk optankning op på samme måde som en optankning. Velkomstbonussen forbliver optanket saldo.

Refunderbarhed

Den månedlige saldo kan ikke refunderes og bortfalder; den optankede saldo kan refunderes som hidtil. Opsigelse af abonnementet giver ikke krav på en forholdsmæssig del af den betalte periode. Refusion af en betaling for abonnementet (reklamation, fejl) afgør volais ejer manuelt, det kan ikke ske via API eller MCP.

Abonnement i REST og MCP

Penge flyttes kun med et menneske ved kortet. Aktivering af abonnementet og manuel betaling returnerer kun et link til Stripe Checkout og trækker aldrig direkte på kortet; hævning af trinnet, genoptagelse af et abonnement sat til at slutte ved periodens udløb og skift til køb fra kortet kræver bekræftelse fra et logget ind menneske i portalen.

• GET /v1/subscription - abonnementets tilstand (subscription eller null), kataloget over trin tiers (id, priceHal, creditHal), topupBalanceHal, available (et nyt abonnement kan aktiveres: tilbuddet er slået til, og intet abonnement kører), recommendation (den billigste vej for forbruget de seneste 30 dage og steady, om forbruget varer ved og ikke blot er en engangstop; null uden tilbud eller uden 30 dages historik) og previousPeriod (den forrige periode med de samme tal som i e-mailen om fornyelsen: usedHal af creditHal, usedPercent, forbrug over den månedlige saldo overHal og den bortfaldne rest expiredHal; kun ved et aktivt abonnement, null i den første periode og når forbruget ikke kan dokumenteres ud fra historikken).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - returnerer {checkoutUrl} til Stripe Checkout, hvorefter abonnementet begynder, når den er gennemført. exhaustionMode (topup eller cap) er obligatorisk; en forbruger uden CVR-nummer skal sende consumerConsent: true (ellers consumer_consent_required). Faktureringsadressen skal være komplet (billing_address_required). Understøtter Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - nedsættelse af trinnet, opsigelse (cancelAtPeriodEnd: true) og skift til loft (exhaustionMode: "cap") udfører den og returnerer {subscription}. Hævning af trinnet, genoptagelse af et abonnement sat til at slutte ved periodens udløb (cancelAtPeriodEnd: false) og exhaustionMode: "topup" ændrer intet og returnerer 409 subscription_confirmation_required med confirmUrl.
• POST /v1/subscription/pay - kun i tilstanden past_due; returnerer {checkoutUrl} til manuel betaling af fornyelsen. Understøtter Idempotency-Key.
• POST /v1/subscription/card - returnerer {checkoutUrl} til udskiftning af abonnementets gemte kort, intet trækkes. Understøtter Idempotency-Key.
• GET /v1/balance har desuden subscription (samme form som ovenfor, ellers null) og topupBalanceHal.

MCP: get_subscription (læsning), create_subscription_link (link til aktivering), update_subscription og cancel_subscription (nedsættelse af trin, opsigelse, loft; hævning, genoptagelse og køb fra kortet returnerer confirmUrl med en sætning om, at det skal bekræftes af et menneske i portalen) og create_subscription_payment_link (manuel betaling). Udskiftning af kort findes ikke i MCP, af samme grund som ved automatisk optankning: herfra trækkes intet.

Skattedokumenter

Dokumentet opstår automatisk ved optankning med kort (både enkelt og automatisk), ved betaling af opsætningen i Nøglefærdig og som korrektionsdokument ved refusion af opsætningen - intet manuelt trin, ingen udstedelse via API'et.

GET /v1/billing/documents?limit&before - de nyeste først, markøren before (Unix ms, eksklusiv) er nextBefore fra den forrige side. Lageret returnerer aldrig selv mere end 100 poster pr. kald, selv om limit beder om mere.

GET /v1/billing/documents/{id} returnerer {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true ved momspligtige fra en anden EU-stat med verificeret momsnummer (VIES), som betaler uden tjekkisk moms. Feltet kind er altid udfyldt - "invoice" ved et almindeligt dokument (også ved dokumenter udstedt før feltet blev indført), "credit_note" ved et korrektionsskattedokument - det opstår automatisk, når ejeren refunderer prisen for opsætningen ved en annulleret Nøglefærdig-bestilling, nummereres i en egen serie OD... og har desuden correctsNumber (nummeret på det korrigerede dokument) og correctionReason (årsagen til refusionen); beløbene netHal/vatHal/grossHal er også ved en kreditnota POSITIVE, minustegnet sætter først PDF'en.

GET /v1/billing/documents/{id}/pdf henter det samme dokument som application/pdf - det sættes friskt ved hver hentning og gemmes ikke. Et fremmed eller ikke-eksisterende id melder den samme fejl (invoice_not_found) i begge endpoints, så svaret ikke afslører, at et fremmed dokument findes.

MCP: list_billing_documents og get_billing_document har samme form som REST. PDF findes kun i REST - MCP har ingen binær kanal til overførsel af en fil.

Fejl

• ledger_unavailable - Bevægelseshistorikken og saldoen kan i øjeblikket ikke læses - prøv igen om lidt.
• invalid_amount - Beløbet for optankning, tærskel eller automatisk betaling er ikke en af de tilbudte faste værdier.
• billing_address_required - Faktureringsadressen mangler eller er ufuldstændig - udfyld den i portalen (/nastaveni) før optankningen, ellers kan der ikke udstedes et gyldigt dokument.
• stripe_not_configured - Betalinger er slået fra for denne kørsel af volai - gælder ikke specifikt din forespørgsel.
• stripe_error - Stripe afviste at oprette en betalingssession - prøv igen om lidt.
• autotopup_not_configured - Den automatiske optankning har aldrig været igennem .../setup - der er intet at slå fra, ændre eller noget kort at skifte.
• invoice_not_found - Der er intet dokument med dette id på kontoen (eller det tilhører en anden konto - svaret er det samme).
• spend_cap_reached - Det månedlige forbrugsloft, du har sat, er nået: nye udgående opkald og SMS afvises, og intet afregnes. Du hæver eller ophæver loftet via PUT eller DELETE /v1/account/spend-cap, ellers gælder det til månedens udgang (til midnat i Prag).
• subscription_cap_reached - Abonnementets loft: både den månedlige og den optankede saldo er brugt op, og kontoen har valgt loft. Udgående opkald, SMS og køb af numre afvises (HTTP 402) indtil næste fornyelse eller manuel optankning.
• subscription_exists - Kontoen har allerede et abonnement; skift af trin, opsigelse og valget efter opbrugt saldo sker via PATCH /v1/subscription.
• subscription_missing - Kontoen har intet aktivt abonnement, som kunne ændres, opsiges eller betales manuelt.
• subscription_canceled - Abonnementet er allerede ophørt (tilstanden canceled): det kan ikke ændres, opsiges eller betales manuelt. Et nyt aktiverer du via POST /v1/subscription/checkout.
• subscription_confirmation_required - Hævning af trinnet, genoptagelse af et abonnement sat til at slutte ved periodens udløb og køb fra kortet bekræftes kun af et menneske i portalen - svaret har confirmUrl, og intet er ændret.
• consumer_consent_required - En forbruger uden CVR-nummer skal ved aktivering bekræfte den udtrykkelige anmodning om påbegyndelse af ydelsen før udløbet af fortrydelsesfristen (consumerConsent: true).
• pausal_unavailable - Tilbuddet om abonnement er for denne konto i øjeblikket slået fra.
• invalid_tier - Det trin, abonnementet allerede har, når der ikke er planlagt noget andet (et trin, som abonnementet allerede er på vej over til, er ikke en fejl og regnes som udført, så det samme PATCH /v1/subscription kan sendes igen efter et udfald; undtagelsen er tilbagevenden til dagens trin, som annullerer en planlagt ændring: ved gentagelsen er der ikke længere noget at annullere); en ukendt værdi uden for "490", "990", "1990" ender som validation.
• subscription_cap_active - Med loft kan automatisk optankning ikke aktiveres; skift først valget efter opbrugt saldo til topup i portalen.
• validation - Konkret ved PATCH /v1/credit/auto-topup: forsøg på at aktivere (enabled: true) eller ændre amountHal direkte - brug i stedet POST .../setup.

Den fulde fejltabel for hvert endpoint finder du i afsnittet Saldo i REST API-referencen.