Ceļveži

Kredīts

Atlikumu, kustību vēsturi un nodokļu rēķinus lasāt gan caur API, gan caur MCP. Maksājums ar karti - gan vienreizējs, gan automātisks - vienmēr iet caur saiti uz Stripe Checkout, ko pabeidz cilvēks; API pats nekad kartei neuzliek maksājumu. Tas pats attiecas uz izvēles mēneša plānu.

Nauda bez PVN, haleri, apraksta valoda

Visas summas šajā API ir veseli skaitļi HALEROS un bez PVN - volai ir PVN maksātājs, bet PVN tiek aprēķināts tikai kredīta papildināšanai ar karti (pārskats lapā /cenik). Kustību aprakstus (GET /v1/credit/ledger) API veido angliski no kustības veida - saglabātā čehu piezīme uz āru neiziet nekad, arī ne citā laukā.

Atlikums, pietiekamība un brīdinājumi

GET /v1/balance atgriež pašreizējo atlikumu plus divus papildu aprēķinus PAPILDINOŠI (esošie klienti, kas lasa tikai balanceHal/balanceCzk/currency, nesabojājas): runway (dailyAverageHal - vidējais dienas tēriņš pēdējā laikā, runwayDays - cik dienas kredīts šādā tempā pietiek, null, ja aprēķināt nevar) un notice - tas pats brīdinājums, ko redzat portāla lapā /prehled, null, ja tāda nav. Astoņas iespējamās notice formas: {kind:"unknown"} (nepietiek datu novērtējumam), {kind:"empty"} (nulles atlikums), {kind:"number_fee",feeHal,dueAt} (3 dienu laikā jāmaksā mēneša maksa par balss vai mobilajiem numuriem un atlikuma tai nepietiek; feeHal ir visu šādu maksu summa, dueAt agrākais maksājuma termiņš; ja ieslēgta automātiskā papildināšana, netiek atgriezts), {kind:"runway",days} (kredīts beigsies pēc days dienām pašreizējā tempā) un četras formas tikai kontam ar mēneša plānu: {kind:"subscription_exhausted_topup",renewsAt} (šī perioda mēneša kredīts ir izlietots un plāns darbojas papildināšanas režīmā, tālākie tēriņi iet no papildinātā kredīta; renewsAt ir perioda beigas ms, kad tiek ieskaitīts jauns mēneša kredīts), {kind:"subscription_cap_reached",renewsAt} (mēneša kredīts ir izlietots, plāns darbojas ar griestiem un papildinātais kredīts neko nesegs, maksas darbības apstājas līdz renewsAt vai līdz manuālai papildināšanai) un {kind:"subscription_past_due"} (plāna atjaunošana neizdevās, saglabāto karti neizdevās debetēt; atjaunošanu samaksājat portālā vai nomaināt karti) un {kind:"subscription_runway",renewsAt,runsOutAt} (atlikums beigsies agrāk, nekā renewsAt tiks ieskaitīts jauns mēneša kredīts; runsOutAt ir novērtējums ms, kad tas beigsies, no plāna piesardzīgā tempa, tāda paša kā mēneša kredīta prognoze plāna kartē portālā: augstākais no 28 dienu vidējā (tikai pie pilnas kredīta vēstures), vidējā darbības tempa pēdējās 7 Prāgas dienās bez maksas par numuriem un vidējā kopš perioda sākuma (tikai pēc tā pirmās nedēļas); runway joprojām rēķina ar 28 dienu vidējo; abonentam tiek atgriezts runway vietā un ieslēgtas automātiskās papildināšanas gadījumā netiek atgriezts). renewsAt ir ms (epoch), tātad tas pats brīdis kā subscription.periodEnd tajā pašā atbildē, kur tā ir ISO 8601 virkne; neviena lauka formāts nemainās. Plānam, kas atcelts perioda beigās, subscription_exhausted_topup, subscription_cap_reached un subscription_runway papildus nes cancelAtPeriodEnd: true: atjaunošana nenāks, renewsAt ir plāna beigas un jauns mēneša kredīts netiks ieskaitīts (pie griestiem turpināt var tikai ar papildināšanu); bez atcelšanas lauka brīdinājumā nav. Kontam ar mēneša plānu atbilde papildus nes subscription (plāna stāvoklis, citādi null) un topupBalanceHal (tikai papildinātais kredīts); balanceHal paliek mēneša un papildinātā kredīta summa, skatiet nodaļu Mēneša plāns.

Kustību vēsture

GET /v1/credit/ledger?limit - jaunākās kustības pirmās, BEZ kursora (tikai limit, 1-200, noklusējums 50) - vecākas kustības par jaunākajām 200 caur API nesasniegsiet, pilnu vēsturi ir portālā /kredit un nodokļu rēķinos. Katrs ieraksts nes type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - pasūtījuma Zem atslēgas labojumu kārta ārpus pakotnes, subscription_grant - mēneša kredīta ieskaitīšana no plāna un subscription_expire - tā neizmantotā atlikuma zudums), amountHal (pozitīvs - pieskaitīšana, negatīvs - atskaitīšana), grossHal (summa ar PVN pie papildināšanas ar karti, citādi null) un angliski veidotu description no veida - pie number_fee papildus ar numuru, uz kuru maksa attiecas. Tēriņiem, ko sedza mēneša kredīts, ir papildus lauks fromSubscriptionHal - tēriņa daļa, ko sedza mēneša kredīts; pie citām kustībām tā nav. Mobilā numura papildinājums vēsturē parādās kā number_fee (pirmais periods pie pirkuma un katra atjaunošana pēc 30 dienām) un sms (sūtīšana no mobilā numura, likme par segmentu ir cenrādī); ja operators SMS no mobilā numura vēlāk noraida, kredīts tiek atgriezts ar ierakstu refund.

Papildināšana ar karti

POST /v1/credit/topup {amountCzk} atgriež {checkoutUrl} - Stripe Checkout saiti, ko pārlūkā atver CILVĒKS. Nekas netiek debetēts, kamēr viņš maksājumu nepabeidz pats. Norēķinu adresei (PUT /v1/account/billing) jābūt pilnīgai PIRMS izsaukuma - bez tās nevar izrakstīt derīgu nodokļu rēķinu (billing_address_required). Atbalsta Idempotency-Key - pēc taimauta var droši atkārtot, neradot divus maksājumus.

Automātiska papildināšana

Caur API automātisko papildināšanu var tikai LASĪT, IZSLĒGT un mainīt SLIEKSNI - ieslēgšana un SUMMAS maiņa notiek tikai caur Stripe Checkout, nekad ar tiešu ierakstu.

Lasīšana un izslēgšana

GET /v1/credit/auto-topup atgriež {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - BEZ kartes numura, tikai zīmols un pēdējie četri cipari. PATCH {enabled: false} izslēdz nekavējoties, PATCH {thresholdHal} maina tikai slieksni (tam jābūt no piedāvātās rindas un zemākam par saglabāto summu, citādi pēc papildināšanas atlikums uzreiz atkal nokristu zem sliekšņa).

Ieslēgšana un summas maiņa

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} atgriež {checkoutUrl} - pēc Checkout pabeigšanas NEKAVĒJOTIES tiek debetēts amountHal kā pirmā papildināšana un tikai ar to tiek saglabāta karte turpmākām automātiskajām papildināšanām. Darbojas arī ar jau agrāk saglabātu karti - tas ir vienīgais ceļš, kā ieslēgt automātisko papildināšanu vai mainīt tās summu. Pēc Checkout pabeigšanas pārlūks atgriežas uz ČEHU portāla lapu (/kredit?automat=zapnuto) arī angliski runājošam klientam - zināma nepilnība, nevis jūsu integrācijas kļūda.

Karte

POST /v1/credit/auto-topup/card atgriež Checkout saiti (kartes nomaiņas režīms, nekas netiek debetēts) saglabātās kartes nomaiņai. DELETE /v1/credit/auto-topup/card atvieno karti NEKAVĒJOTIES - tiek dzēsta visa konfigurācija (slieksnis un summa), ne tikai karte; nākamā ieslēgšana iespējama tikai atkal caur .../setup, kas uzreiz debetē pirmo papildināšanu. Pēc Checkout pabeigšanas pārlūks atgriežas uz ČEHU portāla lapu (/kredit?karta=zmenena) neatkarīgi no konta valodas - tā pati zināmā nepilnība kā iepriekš.

Griesti

Divi NEATKARĪGI griesti: ne vairāk kā 10 000 CZK ieskaitītā kredīta kalendārajā mēnesī un ne vairāk kā 4 papildināšanas KALENDĀRAJĀ DIENĀ - neatkarīgi no tā, cik reižu atlikums nokrītas zem sliekšņa. Pārsniedzot jebkuru no tiem, automātiskā papildināšana pati izslēdzas (disabledReason monthly_cap, attiecīgi daily_cap); spentThisMonthHal/monthlyCapHal atbildē parāda, cik no mēneša griestiem vēl atlicis.

MCP: get_auto_topup (lasīšana) un disable_auto_topup (izslēgšana) - ieslēgšanas, summas maiņas un kartes MCP nav, tā paša iemesla dēļ kā enabled: true REST augstāk.

Mēneša tēriņu griesti

Izvēles drošības mehānisms pret negaidīti augstu rēķinu: paši nosakāt, cik drīkst izmaksāt zvani, SMS un balss aģents kalendārajā mēnesī (pēc Prāgas laika). Funkcija ir ieslēgta tikai kontam, kas griestus iestatījis; bez tiem nekas nemainās un mēneša tēriņš tiek tikai skaitīts.

GET /v1/account/spend-cap atgriež {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Bez griestiem enabled: false un griestu lauki ir null, bet monthSpendHal saņemat vienmēr. Summas ir veselos haleros bez PVN.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} griestus iestata vai maina: capHal ir veselos haleros no 5 000 (50 CZK) līdz 100 000 000 (1 000 000 CZK), warnShare ir griestu daļa no 0,5 līdz 0,99 (noklusējums 0,8), pie kuras nāk brīdinājuma e-pasts, un inboundAboveCap: true ļauj aģentiem turpināt pieņemt ienākošos zvanus arī virs griestiem (noklusējums false, mainot bez lauka, spēkā paliek saglabātā vērtība). DELETE /v1/account/spend-cap griestus atceļ; neesošu griestu atcelšana ir kārtībā.

Sasniedzot griestus, jauni izejošie zvani, zvanīšanas izmēģinājumi, izmēģinājuma zvani un SMS tiek noraidīti ar kodu spend_cap_reached (HTTP 402), nekas netiek rēķināts un atkārtošana nepalīdz, kamēr mēnesis nebeidzas vai jūs griestus nepaaugstināsiet vai neatcelsiet. Aģenta ienākošais zvans pēc vienas frāzes beidzas un neko nemaksā, ja nav inboundAboveCap: true. E-pasts nāk, sasniedzot warnShare un sasniedzot griestus, vienmēr ne vairāk kā reizi mēnesī.

Ko griesti NEapturēs: zvanus, kas tieši norisinās (cena tiek noņemta tikai pēc zvana, tāpēc mēnesis var beigties par to cenu virs griestiem, tāpat kā zvaniem, kas uzskaitīti pēc pusnakts), pāradresēšanu bez aģenta un maksu par numuriem, labojumu kārtu Zem atslēgas un mēneša plānu, kas griestos netiek ieskaitīti. Kontam ar plānu tēriņā tiek skaitīts arī tas, ko sedza mēneša kredīts. Numurs pie Pašu SIP centrāles ar inboundAboveCap: true paliek SIP starpniekā, tāpēc griesti neapturēs izejošos zvanus no centrāles.

MCP: get_spend_cap, set_spend_cap un clear_spend_cap izsauc to pašu servisu kā REST un portāls (sadaļa Mēneša tēriņu griesti pie Kredīta). set_spend_cap klientam summa jāatkārto pirms ieraksta un pēc tā.

Mēneša plāns

Izvēles abonements: katru mēnesi no saglabātās kartes tiek noņemta izvēlētā līmeņa cena un ieskaitīts mēneša kredīts CZK, ko tērē pēc parastā cenrāža. Likmes un sekunžu uzskaite nemainās, plāns ir slānis virs tām. Līmeņi ir trīs, un tier ir to cena CZK bez PVN: "490", "990" un "1990"; katra līmeņa cenas un kredītu atgriež GET /v1/subscription laukā tiers.

Divi kredīta veidi

Mēneša kredīts nāk no plāna, perioda beigās zūd un nav atgriežams. Papildinātais kredīts (papildināšana, sveiciena bonuss, korekcijas) nebeidzas un ir atgriežams kā līdz šim. Konta atlikums - balanceHal komandā GET /v1/balance, portālā un visos vārtos (zvana minimums, parāda limits, brīdinājumi) - ir abu veidu summa. Pats papildinātais kredīts ir topupBalanceHal, atlikušais mēneša kredīts subscription.monthlyRemainingHal. Parāds var rasties tikai papildinātajā kredītā.

Tēriņu secība

Katrs tēriņš iet vispirms no mēneša kredīta un atlikums no papildinātā - zvani pa sekundēm, aģents, maksa par numuriem un mobilajiem numuriem, SMS, zvanīšanas izmēģinājumi un izejošie uzdevumi. Sadalījums ir atomārs un ierakstīts ledger: ar mēneša kredītu segts tēriņš nes fromSubscriptionHal (daļa, ko sedza mēneša kredīts). Īpašnieka korekcijas (admin, arī negatīvas) un atmaksa par nenosūtītu SMS (refund) attiecas tikai uz papildināto kredītu.

Periods un ieskaitīšana

Periods ilgst vienu mēnesi no sekmīgā maksājuma (31. 1. dod 28. 2.). Mēneša kredīts tiek ieskaitīts tikai pēc apstiprināta maksājuma ar ierakstu subscription_grant, un ieskaitīšana ir idempotenta pēc maksājuma id. Ja kontam tobrīd ir parāds papildinātajā kredītā, tas vispirms tiek dzēsts no jaunā mēneša kredīta, lai papildinātais kredīts neatliktu negatīvs.

Zudums

Neizmantotais mēneša kredīta atlikums zūd atjaunošanas dienā (ieraksts subscription_expire ar negatīvu summu), abonementa beigās vai automātiskajā drošības mehānismā, kad periods beidzies pirms vairāk nekā 36 stundām bez atjaunošanas. Ja maksājums neizdodas, atlikums jau ir zudis un jauns kredīts netiek ieskaitīts; līdz samaksai konts darbojas tikai uz papildinātā kredīta.

Izvēle pēc izlietošanas

Ieslēdzot, obligāti jāizvēlas exhaustionMode, bez noklusējuma. topup: pēc mēneša kredīta izlietošanas no saglabātās kartes tiek piepirkts papildinātais kredīts - tā ir mūsdienu automātiskā papildināšana ar tiem pašiem ierobežojumiem un e-pastiem. cap (griesti): nekas netiek piepirkts, izejošie zvani, SMS un numuru pirkumi tiek noraidīti ar kļūdu subscription_cap_reached (HTTP 402), un, kad atlikums nokrītas zem nulles, apstājas arī ienākošie zvani, pāradresēšana un SIP piekļuve (apstāšanās pie nulles; atjaunojas pēc papildināšanas vai ar jauno mēneša kredītu). Ar griestiem nevar ieslēgt automātisko papildināšanu (subscription_cap_active); pārslēgšana uz griestiem to izslēdz. Visvairāk, ko mēnesī ar griestiem samaksāsiet, ir plāna cena.

Līmeņa maiņa, atcelšana, atjaunošana

Līmeņa maiņa (uz augšu un uz leju) stājas spēkā no nākamā perioda, bez izlīdzināšanas. Atcelšana ir cancelAtPeriodEnd: true: kredīts ir spēkā līdz perioda beigām, tad zūd un stāvoklis ir canceled; līdz perioda beigām atcelšanu var atsaukt. Caur REST vai MCP nevar paaugstināt līmeni, atjaunot atceltu plānu vai pārslēgt uz piepirkšanu no kartes - šie soļi palielina vai no jauna ieslēdz atkārtotu debetēšanu, tāpēc atgriež subscription_confirmation_required ar confirmUrl, ko cilvēks atver un apstiprina portālā (derīgs 24 stundas).

Padoms pirms atjaunošanas

Trīs dienas pirms atjaunošanas (vēlākais dienu iepriekš) nāk e-pasts, bet tikai tad, ja pie līdzšinējā tēriņa jums iznāktu lētāk maksāt pa sekundēm vai zemāks līmenis. Spēkā tas pats noteikums kā padomam atjaunošanas e-pastā un portālā: citam ceļam jāiznāk vismaz par 50 CZK un 5 % lētākam. Novērtējums visam periodam ņem augstāko no tempiem kopš perioda sākuma un par pēdējām 7 dienām un nekad nav zemāks par tēriņu pēdējās 30 dienās, no kura padoms portālā; rindas Līmenis un Atcelšana tāpēc pēc noklikšķināšanas neteiks, ka līmenis der. E-pastā ir precīzs atjaunošanas datums un laiks, un tas nāk ne vairāk kā reizi periodā, nekad plānam, kas atcelts perioda beigās, ar ieplānotu līmeņa maiņu, bez saglabātas kartes vai plānam, kas gaida maksājumu. Poga tajā portālā uzreiz atver rindu Atcelšana (/kredit?pausal=zrusit) vai Līmenis (/kredit?pausal=stupen). Atjaunošanas e-pasts pēc tam atkal dod padomu pēc faktiskā visa perioda tēriņa, tāpēc padoms var iznākt arī citādi.

Neapmaksāta atjaunošana

Debetēšana no saglabātās kartes tiek mēģināta atjaunošanas dienā, pēc 2 un pēc 4 dienām. Pēc pirmās neveiksmes stāvoklis ir past_due, nāk e-pasts ar saiti uz manuālu maksājumu un kartes maiņu, un mēneša kredīts ir 0; manuālo maksājumu atgriež POST /v1/subscription/pay. Pēc trešās neveiksmes plāns beidzas (canceled), papildinātais kredīts un konts darbojas tālāk.

PVN un rēķini

Cenas ir bez PVN. PVN režīms tiek nolasīts pirms katras debetēšanas, tāpēc maksātājs no citas ES valsts ar pārbaudītu PVN numuru maksā bez Čehijas PVN (reverse charge) un rēķins to atspoguļo. Nodokļu rēķinu par katru samaksāto periodu izraksta pats volai (nodokļa bāze ir līmeņa cena, nevis ieskaitītais kredīts), un to atradīsiet GET /v1/billing/documents.

Saistība ar bonusu un pirmo papildināšanu

Plāna ieslēgšana tiek skaitīta kā pirmais maksājums: atbloķē SMS no kopīgā sūtītāja, pāradresēšanu, otro numuru, mobilo numuru un automātiskās papildināšanas karti tāpat kā papildināšana. Sveiciena bonuss paliek papildinātais kredīts.

Atgriezeniskums

Mēneša kredīts nav atgriežams un zūd; papildinātais kredīts ir atgriežams kā līdz šim. Plāna atcelšana neveido tiesības uz samaksātā perioda proporcionālu daļu. Plāna maksājuma atmaksu (reklamācija, kļūda) manuāli risina volai īpašnieks, caur API vai MCP tas nav iespējams.

Plāns REST un MCP

Nauda kustas tikai tad, kad cilvēks ir pie kartes. Plāna ieslēgšana un manuālais maksājums atgriež tikai saiti uz Stripe Checkout un nekad tieši nedebetē karti; līmeņa paaugstināšana, plāna, kas iestatīts uz beigām perioda beigās, atjaunošana un pārslēgšana uz piepirkšanu no kartes prasa pieteikta cilvēka apstiprinājumu portālā.

• GET /v1/subscription - plāna stāvoklis (subscription vai null), līmeņu katalogs tiers (id, priceHal, creditHal), topupBalanceHal, available (var ieslēgt jaunu plānu: piedāvājums ir ieslēgts un neviens plāns nedarbojas), recommendation (lētākais ceļš pēdējo 30 dienu tēriņam un steady, vai tēriņš ir ilgstošs, nevis vienreizējs kāpums; null bez piedāvājuma vai bez 30 dienu vēstures) un previousPeriod (iepriekšējais periods ar tiem pašiem skaitļiem kā atjaunošanas e-pasts: usedHal no creditHal, usedPercent, tēriņš virs mēneša kredīta overHal un zudušais atlikums expiredHal; tikai aktīvam plānam, null pirmajā periodā un kad tēriņu no vēstures nevar pamatot).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - atgriež {checkoutUrl} uz Stripe Checkout, pēc kura pabeigšanas plāns sākas. exhaustionMode (topup vai cap) ir obligāts; patērētājam bez uzņēmuma reģistrācijas numura jānosūta consumerConsent: true (citādi consumer_consent_required). Norēķinu adresei jābūt pilnīgai (billing_address_required). Atbalsta Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - līmeņa pazemināšanu, atcelšanu (cancelAtPeriodEnd: true) un pārslēgšanu uz griestiem (exhaustionMode: "cap") izpilda un atgriež {subscription}. Līmeņa paaugstināšana, plāna, kas iestatīts uz beigām perioda beigās, atjaunošana (cancelAtPeriodEnd: false) un exhaustionMode: "topup" neko nemaina un atgriež 409 subscription_confirmation_required ar confirmUrl.
• POST /v1/subscription/pay - tikai stāvoklī past_due; atgriež {checkoutUrl} atjaunošanas manuālai samaksai. Atbalsta Idempotency-Key.
• POST /v1/subscription/card - atgriež {checkoutUrl} plāna saglabātās kartes nomaiņai, nekas netiek debetēts. Atbalsta Idempotency-Key.
• GET /v1/balance papildus nes subscription (tāda pati forma kā augstāk, citādi null) un topupBalanceHal.

MCP: get_subscription (lasīšana), create_subscription_link (saite uz ieslēgšanu), update_subscription un cancel_subscription (līmeņa pazemināšana, atcelšana, griesti; paaugstināšana, atjaunošana un piepirkšana atgriež confirmUrl ar teikumu, ka to jāapstiprina cilvēkam portālā) un create_subscription_payment_link (manuālais maksājums). Kartes nomaiņas MCP nav, tā paša iemesla dēļ kā pie automātiskās papildināšanas: no šejienes nekas netiek debetēts.

Nodokļu rēķini

Rēķins rodas automātiski, papildinot kredītu ar karti (gan vienreizēji, gan automātiski), samaksājot Zem atslēgas ierīkošanu un kā korekcijas rēķins, atgriežot ierīkošanas maksu - nekāda manuāla soļa, nekādas izrakstīšanas caur API.

GET /v1/billing/documents?limit&before - jaunākie pirmie, kursors before (Unix ms, ekskluzīvs) ir nextBefore no iepriekšējās lapas. Krātuve pati nekad neatgriež vairāk par 100 ierakstiem vienā izsaukumā, pat ja limit prasa vairāk.

GET /v1/billing/documents/{id} atgriež {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true maksātājiem no citas ES valsts ar pārbaudītu PVN numuru (VIES), kuri maksā bez Čehijas PVN. Lauks kind ir vienmēr aizpildīts - "invoice" pie parasta rēķina (arī pie rēķiniem, kas izrakstīti pirms lauka ieviešanas), "credit_note" pie korekcijas nodokļu rēķina - tas rodas automātiski, kad īpašnieks atgriež ierīkošanas cenu atceltam pasūtījumam Zem atslēgas, tiek numurēts ar savu sēriju OD... un papildus nes correctsNumber (labotā rēķina numurs) un correctionReason (atgriešanas iemesls); summas netHal/vatHal/grossHal ir arī kredītrēķinam POZITĪVAS, mīnusa zīmi dod tikai PDF.

GET /v1/billing/documents/{id}/pdf lejupielādē to pašu rēķinu kā application/pdf - tiek veidots no jauna katrā lejupielādē, netiek glabāts. Svešu vai neesošu id abi galapunkti ziņo ar to pašu kļūdu (invoice_not_found), lai no atbildes nevarētu noteikt, ka svešs rēķins pastāv.

MCP: list_billing_documents un get_billing_document ir tādas pašas formas kā REST. PDF ir tikai REST - MCP nav bināra kanāla faila pārsūtīšanai.

Kļūdas

• ledger_unavailable - Kustību vēsturi un atlikumu pašlaik neizdodas nolasīt - mēģiniet vēlreiz pēc brīža.
• invalid_amount - Papildināšanas, sliekšņa vai automātiskā maksājuma summa nav viena no piedāvātajām fiksētajām vērtībām.
• billing_address_required - Norēķinu adrese trūkst vai ir nepilnīga - papildiniet to portālā (/nastaveni) pirms papildināšanas, citādi nevar izrakstīt derīgu rēķinu.
• stripe_not_configured - Maksājumi šim volai darbības režīmam ir izslēgti - tas neattiecas konkrēti uz jūsu pieprasījumu.
• stripe_error - Stripe atteicās izveidot maksājuma sesiju - mēģiniet vēlreiz pēc brīža.
• autotopup_not_configured - Automātiskā papildināšana vēl nekad nav izgājusi cauri .../setup - nav ko izslēgt, mainīt, ne kādu karti nomainīt.
• invoice_not_found - Rēķina ar šo id kontā nav (vai tas pieder citam kontam - atbilde ir tāda pati).
• spend_cap_reached - Jūsu iestatītie mēneša tēriņu griesti ir sasniegti: jauni izejošie zvani un SMS tiek noraidīti un nekas netiek rēķināts. Griestus paaugstināt vai atcelt var ar PUT vai DELETE /v1/account/spend-cap, citādi tie ir spēkā līdz mēneša beigām (līdz pusnaktij Prāgā).
• subscription_cap_reached - Plāna griesti: gan mēneša, gan papildinātais kredīts ir izlietots un kontam ir izvēlēti griesti. Izejošie zvani, SMS un numuru pirkumi tiek noraidīti (HTTP 402) līdz nākamajai atjaunošanai vai manuālai papildināšanai.
• subscription_exists - Kontam plāns jau ir; līmeņa maiņa, atcelšana un izvēle pēc izlietošanas notiek caur PATCH /v1/subscription.
• subscription_missing - Kontam nav aktīva plāna, ko varētu mainīt, atcelt vai manuāli samaksāt.
• subscription_canceled - Plāns jau ir beidzies (stāvoklis canceled): to nevar mainīt, atcelt vai manuāli samaksāt. Jaunu ieslēdzat caur POST /v1/subscription/checkout.
• subscription_confirmation_required - Līmeņa paaugstināšanu, plāna, kas iestatīts uz beigām perioda beigās, atjaunošanu un piepirkšanu no kartes apstiprina tikai cilvēks portālā - atbilde nes confirmUrl un nekas nav mainījies.
• consumer_consent_required - Patērētājam bez uzņēmuma reģistrācijas numura ieslēdzot jāapstiprina skaidrs lūgums sākt izpildi pirms atteikuma termiņa beigām (consumerConsent: true).
• pausal_unavailable - Plāna piedāvājums šim kontam pašlaik ir izslēgts.
• invalid_tier - Līmenis, kāds plānam jau ir, ja nav ieplānots neviens cits (līmenis, uz kuru jau notiek pāreja, nav kļūda un tiek uzskatīts par izpildītu, tāpēc to pašu PATCH /v1/subscription pēc pārtraukuma var sūtīt vēlreiz; izņēmums ir atgriešanās uz šodienas līmeni, kas ieplānoto maiņu atceļ: atkārtojot vairs nav ko atcelt); nezināma vērtība ārpus "490", "990", "1990" beidzas kā validation.
• subscription_cap_active - Ar griestiem nevar ieslēgt automātisko papildināšanu; vispirms portālā pārslēdziet izvēli pēc izlietošanas uz topup.
• validation - Konkrēti pie PATCH /v1/credit/auto-topup: mēģinājums ieslēgt (enabled: true) vai mainīt amountHal tieši - izmantojiet POST .../setup tā vietā.

Pilnu kļūdu tabulu katram galapunktam atradīsiet sadaļā Kredīts REST API atsaucē.