Un MSISDN non valido non deve generare addebiti

Un MSISDN non valido non deve generare addebiti.

Validazione in ingresso vs errore a valle

Durante l'instradamento di traffico SMS o OTP ad alto volume, distinguere tra un indirizzo di destinazione non valido all'ingresso (ingress) e un errore di consegna a valle (downstream) è fondamentale per l'integrità finanziaria. Un MSISDN non valido deve essere rifiutato immediatamente al gateway API prima che avvenga qualsiasi transazione sul libro mastro. Se un numero non valido supera i controlli di ingresso, potrebbe generare un DLR a valle con uno stato sconosciuto, il che appare come una spesa ma non produce alcuna consegna effettiva. IOSOR applica rigide regole di validazione per evitare questo scenario, garantendo che il tuo saldo sia protetto da formati di destinazione errati.

Il motore di analisi E.164

Ogni richiesta API destinata a un numero mobile viene sottoposta a un'analisi in tempo reale rispetto allo standard globale E.164. La piattaforma verifica il prefisso internazionale, il prefisso nazionale di destinazione e la lunghezza del numero dell'abbonato. Se il formato non è valido, il gateway restituisce immediatamente un errore HTTP 400 Bad Request. Questa validazione just-in-time (JIT) garantisce che i percorsi di instradamento inesistenti vengano bloccati prima che vengano allocate risorse o applicata qualsiasi trattenuta prepagata. Questo meccanismo impedisce ai numeri non validi di attivare query verso gli operatori a valle che comporterebbero costi nascosti.

Regole del libro mastro e trattenute prepagate

Per mantenere un saldo sano, IOSOR utilizza un libro mastro in tempo reale. Quando viene accettata una richiesta SMS valida, sul tuo saldo viene applicata una trattenuta prepagata temporanea. Se il messaggio viene instradato con successo, la trattenuta si converte in un addebito. Tuttavia, se il numero viene contrassegnato come non valido all'ingresso, non viene creata alcuna trattenuta e non viene addebitato alcun importo. Ciò protegge la tua soglia minima prepagata di USD 20 dall'essere erosa da stringhe di destinazione non corrette. Per gli account in crescita, una revisione flessibile intorno a USD 1,000/mese aiuta a ottimizzare le tabelle di instradamento e a regolare i limiti MRC per le risorse dedicate.

Payload dei webhook e codici di errore

Quando un messaggio viene rifiutato all'ingresso, la risposta dell'API contiene un payload di errore specifico. Invece di attendere un webhook DLR asincrono, la tua applicazione riceve un errore sincrono immediato. Questo payload include il parametro non valido e un chiaro codice di rifiuto. Per i numeri validi, il sistema assegnerà il percorso di instradamento e invierà aggiornamenti di stato tramite webhook, inclusi gli eventi STOP e Verify OK, garantendo la massima trasparenza sulla pipeline di messaggistica senza sprecare cicli API.

Risorse per gli sviluppatori e integrazione

Per creare un'integrazione robusta che eviti spese non necessarie, gli sviluppatori dovrebbero implementare la validazione lato client prima di effettuare chiamate alle API. Consulta queste guide essenziali per ottimizzare la tua implementazione:

• Validazione del formato telefonico E.164 nei punti di ingresso API
• Settimana pilota del portafoglio: verità su hold e debit
• checklist di acquisto API SMS

Inizia con IOSOR

Dalla sandbox fate POST verso una destinazione senza prefisso e una di lunghezza impossibile. Attendete HTTP 400 e un ledger intatto — né hold né addebito. Poi inviate un E.164 valido e confermate che l’hold compare solo dopo accept. Se il denaro si è mosso sulla coppia non valida, il parse in ingresso è rotto.

Sintesi IOSOR

Un rifiuto di formato in ingresso non è un fallimento di consegna.