IOSOR

IOSOR Vedomosti

Keď prepaid hold zlyhá: auto-refund a pravda o stave

Berte neúspešný prepaid hold ako udalosť peňaženky: automatické uvoľnenie alebo refund, exportovateľné úprimné stavy a nikdy Activated/Delivered bez skutočného výsledku.

Prepaid hold, ktorý sa nedá dokončiť, musí nechať peniaze a stav v podobe, ktorú finance obháji. Zlyhanie nie je divadlo «skúste neskôr». Rezervácia sa vráti do available balance, explicitný refund otočí settled sumu, alebo pomenovaný terminálny stav blokuje retry, kým nie je dôkaz.

IOSOR je white-label prepaid. Rovnaké pravidlo platí pre messaging, verification, email, voice a JIT čísla na jednej peňaženke. Minimum USD 20 je podlaha pilotu, nie dôkaz, že fail-cesta funguje. Review okolo USD 1,000/mesiac len robí fail riadky viditeľnejšími.

Zlyhanie je udalosť peňaženky, nie toast

Spinnery checkoutu a bannery «pending» nie sú peňažná pravda. Po faili peňaženka uvoľnila hold, vrátila debit alebo zmrazila intent s dôvodom na export. Úspech pri otvorenej rezervácii = ledger klame. Happy path: rezervácia predplateného zostatku pred prvým odpísaním; tu je fail-cesta.

Výsledok Pohyb peňaženky Čitateľný stav
Odmietnutie validácie pred prácou Bez holdu alebo okamžitý release Rejected — bez debit
Zlyhanie fulfillmentu pod holdom Plný release rezervy Failed — prostriedky vrátené
Timeout bez dôkazu completion Release podľa expiry Timed out — prostriedky vrátené
Settled na otočenie Explicitný refund riadok Refunded — viazané na intent
Neznámy mid-flight Freeze retry; bez druhého debit Needs attention — vyšetrovanie

Auto-refund a release musia byť automatické

Manuálne «ops to neskôr opraví» nie je produkt. Release nepoužitého holdu a refund chybného settle spúšťajú rovnaké pravidlá ako rezervácia. Duplikáty s rovnakým idempotency key znovu použijú peňažný výsledok — pozri idempotencia, opakovania a peniaze.

Release obnoví nepoužitú rezervu. Refund otočí settled debit. Klient potrebuje timestampy, dôvody a business intent ID. Tiché úpravy zostatku bez riadku ledger sú zakázané. Swap po zlyhaní nákupu čísla: zlyhanie objednávky DID refundácia a výmena.

Slovník stavov, ktorý finance exportuje

Vyžadujte krátky zoznam, ktorý prežije CSV:

funds held; completed / settled; released; refunded; needs attention; cancelled.

Nevymýšľajte «Activated», «Delivered» ani «Live» pre intent bez zdroja alebo billable unit. «Needs attention» je fronta práce, nie synonymum úspechu. Stav bez sumy, meny a correlation ID je divadlo.

Nikdy nefalšujte Activated ani Delivered

Falošné odznaky úspechu pália dôveru rýchlejšie než prázdne hľadanie. Messaging fail ≠ delivered; neotvorená verify ≠ verified; JIT bez assign ≠ Activated. Low balance a over-cap odmietajú pred holdom — zastavenie pri nízkom zostatku.

Checklist kupujúceho pre úprimnosť failu

  1. Končí každý failed hold release, refundom alebo needs-attention s vlastníkom?
  2. Sú release a refund automatické z produktových eventov, nie z chatu?
  3. Vie finance spojiť fail riadky s pôvodným intent ID bez podpory?
  4. Pohybuje rovnaký kľúč peniazmi najviac raz?
  5. Sú klientské chyby brand-safe bez mien upstream?
  6. Blokujú stop-lines nové holdy pri nízkom available? Pozri hranice zastavenia peňaženky pred produkčnou prevádzkou.

Začnite s IOSOR

Vynútene nechajte zlyhať prepaid hold, ktorý sa nedá dokončiť: strop, zamietnutie alebo nedostatok. Dokážte návrat na available alebo explicitný riadok refund. Exportujte fail stav, ktorý financie obhája. Zopakujte rovnaký kľúč bez druhého pohybu. Je to pravda zlyhania hold, nie uvoľnenie po mŕtvom assign.

Related: kontrola prepaid výdavkov

Zhrnutie IOSOR

Zlyhaný hold je udalosť peňaženky, nie divadlo úspechu.

Robte: auto-uvoľnenie alebo refund a pomenovaný stav. Nerobte: vymýšľať Activated alebo Delivered.

Pomohol tento sprievodca?

Súvisiace návody