IOSOR Znalosti

Když prepaid hold selže: auto-refund a pravda o stavu

Berte neúspěšný prepaid hold jako událost peněženky: automatické uvolnění nebo refund, exportovatelné poctivé stavy a zákaz Activated/Delivered bez skutečného výsledku.

Prepaid hold, který nelze dokončit, musí nechat peníze a stav ve formě, kterou finance obhájí. Selhání není divadlo «zkuste později». Rezervace se vrátí do available balance, explicitní refund otočí settled částku, nebo pojmenovaný terminální stav blokuje retry, dokud není důkaz.

IOSOR je white-label prepaid. Stejné pravidlo platí pro messaging, verification, email, voice a JIT čísla na jedné peněžence. Minimum USD 20 je podlaha pilotu, ne důkaz, že fail-cesta funguje. Review kolem USD 1,000/měsíc jen činí fail řádky viditelnějšími.

Selhání je událost peněženky, ne toast

Spinnery checkoutu a bannery «pending» nejsou peněžní pravda. Po failu peněženka uvolnila hold, vrátila debit, nebo zmrazila intent s důvodem k exportu. Úspěch při otevřené rezervaci = ledger lže. Happy path: rezervace předplaceného zůstatku před prvním stržením; zde je fail-cesta.

Výsledek Pohyb peněženky Čitelný stav
Odmítnutí validace před prací Bez holdu nebo okamžitý release Rejected — bez debit
Selhání fulfillmentu pod holdem Plný release rezervy Failed — prostředky vráceny
Timeout bez důkazu completion Release dle expiry Timed out — prostředky vráceny
Settled k otočení Explicitní refund řádek Refunded — vázáno na intent
Neznámý mid-flight Freeze retry; bez druhého debit Needs attention — vyšetřování

Auto-refund a release musí být automatické

Manuální «ops to později opraví» není produkt. Release nepoužitého holdu a refund chybného settle spouští stejná pravidla jako rezervace. Duplikáty se stejným idempotency key znovu použijí peněžní výsledek — viz idempotence, opakování a peníze.

Release obnoví nepoužitou rezervu. Refund otočí settled debit. Klient potřebuje timestampy, důvody a business intent ID. Tiché úpravy zůstatku bez řádku ledger jsou zakázány. Swap po selhání nákupu čísla: selhání objednávky DID refundace a výměna.

Slovník stavů, který finance exportuje

Vyžadujte krátký seznam, který přežije CSV:

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

Nevymýšlejte «Activated», «Delivered» ani «Live» pro intent bez zdroje nebo billable unit. «Needs attention» je fronta práce, ne synonymum úspěchu. Stav bez částky, měny a correlation ID je divadlo.

Nikdy nefalšujte Activated ani Delivered

Falešné odznaky úspěchu pálí důvěru rychleji než prázdné hledání. Messaging fail ≠ delivered; neotevřená verify ≠ verified; JIT bez assign ≠ Activated. Low balance a over-cap odmítají před holdem — zastavení při nízkém zůstatku.

Checklist kupujícího pro poctivost failu

  1. Končí každý failed hold release, refundem nebo needs-attention se vlastníkem?
  2. Jsou release a refund automatické z produktových eventů, ne z chatu?
  3. Umí finance spojit fail řádky s původním intent ID bez podpory?
  4. Pohybuje stejný klíč penězi nejvýše jednou?
  5. Jsou klientské chyby brand-safe bez jmen upstream?
  6. Blokují stop-lines nové holdy při nízkém available? Viz hranice zastavení peněženky před produkčním provozem.

Začněte s IOSOR

Vynuceně nechte selhat prepaid hold, který nelze dokončit: strop, zamítnutí nebo nedostatek. Dokažte návrat na available nebo explicitní řádek refund. Exportujte fail stav, který finance obhájí. Zopakujte stejný klíč bez druhého pohybu. Je to pravda selhání hold, ne uvolnění po mrtvém assign.

Related: kontrola prepaid výdajů

Shrnutí IOSOR

Selhaný hold je událost peněženky, ne divadlo úspěchu.

Dělejte: auto-uvolnění nebo refund a pojmenovaný stav. Nedělejte: vymýšlet Activated nebo Delivered.

Byl tento průvodce užitečný?

Související průvodci