Neplatné MSISDN nesmí být účtováno

Neplatné MSISDN nesmí být účtováno.

Validace na vstupu vs. selhání na downstreamu

Při směrování velkých objemů SMS nebo OTP provozu je pro finanční integritu zásadní rozlišovat mezi neplatnou cílovou adresou na vstupu (ingress) a selháním doručení dále v síti (downstream). Neplatné MSISDN musí být okamžitě odmítnuto na API bráně ještě předtím, než dojde k jakékoli transakci v účetní knize. Pokud neplatné číslo projde vstupní kontrolou, může generovat downstream DLR s neznámým stavem. To sice vypadá jako útrata, ale k doručení nedojde. IOSOR uplatňuje přísná pravidla validace, aby tomu zabránil a zajistil ochranu vašeho zůstatku před chybnými formáty cílových adres.

Analizační nástroj E.164

Každý požadavek API cílící na mobilní číslo prochází analýzou v reálném čase podle globálního standardu E.164. Platforma kontroluje kód země, národní směrové číslo a délku čísla účastníka. Pokud je formát neplatný, brána okamžitě vrátí chybu HTTP 400 Bad Request. Tato validace v reálném čase (JIT) zajišťuje, že neexistující směrovací cesty jsou zablokovány dříve, než jsou přiděleny zdroje nebo uplatněna předplacená blokace. Tento mechanismus brání tomu, aby neplatná čísla spouštěla dotazy u operátorů, které přinášejí skryté náklady.

Pravidla účetní knihy a předplacené blokace

Pro udržení přesného zůstatku využívá IOSOR účetní knihu v reálném čase. Jakmile je přijat platný požadavek na SMS, na vašem zůstatku se vytvoří dočasná předplacená blokace (hold). Pokud je zpráva úspěšně směrována, blokace se změní na odpis (debet). Pokud je však číslo na vstupu označeno jako neplatné, žádná blokace se nevytvoří a z účtu se odepíše přesně USD 0. To chrání váš minimální limit USD 20 před vyčerpáním kvůli chybným cílovým řetězcům. U účtů, které rostou, pomáhá orientační kontrola kolem USD 1.000/měsíc optimalizovat směrovací tabulky a upravit limity MRC pro vyhrazené zdroje.

Webhooky a chybové kódy

Pokud je zpráva na vstupu odmítnuta, odpověď API obsahuje specifická data o chybě. Místo čekání na asynchronní webhook DLR obdrží vaše aplikace okamžitou synchronní chybu. Tato odpověď obsahuje neplatný parametr a jasný kód odmítnutí. U platných čísel systém přiřadí směrovací cestu a odesílá aktualizace stavu prostřednictvím webhooku, včetně událostí STOP a Verify OK, což zajišťuje plnou transparentnost vašeho provozu bez plýtvání API cykly.

Vývojářské zdroje a integrace

Chcete-li vybudovat robustní integraci, která zabrání zbytečným výdajům, měli by vývojáři implementovat validaci na straně klienta před odesláním požadavku na API. Pro optimalizaci vaší implementace si prostudujte tyto klíčové průvodce:

• Ověření formátu telefonních čísel E.164 na vstupních bodech API
• Wallet pilotní týden: pravda o hold a debet na live provozu
• nákupní checklist SMS API

Začněte s IOSOR

Z pískoviště pošlete POST na cíl bez kódu země a na číslo nemožné délky. Čekejte HTTP 400 a nedotčený ledger — žádný hold, žádný debet. Pak pošlete platné E.164 a ověřte, že hold se objeví až po accept. Pokud se peníze pohnuly na neplatném páru, vstupní rozbor je rozbitý.

Shrnutí IOSOR

Odmítnutí formátu na vstupu není selhání doručení. Neplatné MSISDN nesmí nikdy otevřít hold. Dělejte: rozebírejte E.164 dřív, než se peníze pohnou. Nedělejte: čekat na unknown DLR, které vysvětlí debet, jenž nemá existovat. Ledger mlčí, dokud číslo není dobře sestavené.