OTP Verification API
per Rivenditori
Rivendi numeri di verifica SMS monouso a partire da $0,10 tramite un'unica API REST. Provisioning istantaneo, rimborso completo sulle attivazioni non utilizzate, e webhook firmati — costruisci la tua piattaforma OTP sopra numeri di operatori reali.
Un'API per ogni verifica SMS monouso di cui hai bisogno
Le inbox SMS pubbliche gratuite sono leggibili pubblicamente e già segnalate da tutte le principali piattaforme. Creare le tue relazioni con gli operatori per numeri monouso è costoso da impostare per qualcosa che i clienti usano una volta e poi scartano.
L'API OTP VRNUM ti offre un pool privato e attivo di numeri di operatori reali su richiesta. Attiva uno, ricevi il codice, e il numero non viene mai mostrato a nessun altro — con il tuo margine già applicato a ogni prezzo che mostri.
Dall'ordine al codice verificato
Quattro chiamate coprono l'intero ciclo di vita dell'OTP.
Controlla il catalogo
GET /otp-catalog per servizi live, paesi e prezzi — applica il tuo margine prima di mostrarli ai clienti.
Ordina un numero
POST /otp-numbers con un servizio, paese e Idempotency-Key. Un numero viene restituito immediatamente.
Ottieni il codice
GET /otp-numbers/:id verifica in tempo reale l'SMS, oppure attendi l'evento webhook otp.completed.
Rinvia o rimborsa
Nessun codice ancora? Prova /resend, oppure /cancel per un rimborso completo immediato nel tuo wallet.
Ordina un numero OTP in una sola richiesta
clientReference è il tuo ID opaco — allegalo per riconciliare gli ordini con i tuoi record interni dei clienti.
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'Un ciclo completo di vita dell'ordine OTP
Catalogo, ordinazione, rinvio, annullamento/rimborso e webhook — un'unica API JSON coerente.
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceI documenti completi di richiesta/risposta e le tue chiavi sono disponibili nella tuadashboarddopo aver effettuato l'accesso.
Chi costruisce sull'API di verifica OTP
Qualsiasi prodotto che richiede un numero di telefono reale per un singolo passaggio di verifica.
Piattaforme di verifica SMS
Rivendi numeri OTP ai tuoi clienti sotto il tuo marchio, con il tuo ricarico su ogni servizio.
QA e automazione dei test
Crea account di test usa e getta sui servizi di produzione senza utilizzare numeri di telefono personali.
Strumenti per bot e agenzie
Fornire numeri in modo programmato per i flussi di lavoro di creazione account sviluppati per i clienti.
Strumenti per sviluppatori
Offri 'verifica con SMS' come funzione nella tua app o SDK senza possedere infrastruttura telecom.
Abbastanza affidabile da poter fatturare ai tuoi clienti
Chiavi di idempotenza
Riprova in sicurezza sui timeout — la stessa Idempotency-Key restituisce sempre l'ordine originale, mai un duplicato.
Webhook firmati
eventi otp.completed, number.provisioned e number.provisioning_failed, firmati con X-VRNUM-Signature.
Ritenti automatici
Le consegne dei webhook fallite vengono ritentate secondo un programma di backoff (5min, 30min, 2h, 6h, 24h) prima che molliamo.
Limiti di velocità trasparenti
60 richieste/minuto per chiave con intestazioni X-RateLimit-* in ogni risposta.
Fatturazione tramite portafoglio
Nessuna fattura o abbonamento — ordini e rimborsi vengono accreditati sul tuo saldo immediatamente.
Codici di errore stabili
Ogni errore restituisce un codice JSON normalizzato su cui la tua integrazione può fare affidamento.
Domande frequenti
Posso rivendere numeri OTP tramite l'API VRNUM?
Sì. Gli endpoint otp-catalog e otp-numbers restituiscono solo il prezzo di rivendita. Imposta il tuo margine per servizio e paese — i tuoi clienti non vedono mai il costo interno di VRNUM.
Cosa succede se il codice OTP non arriva mai?
Chiama POST /otp-numbers/:id/cancel su un'attivazione ancora in attesa per ottenere un rimborso completo nel tuo portafoglio. Puoi anche chiamare prima l'endpoint di reinvio.
Quanto tempo resta valida un'attivazione OTP tramite l'API?
Ogni attivazione resta attiva per 20 minuti dalla creazione. Annulla prima della scadenza per ottenere un rimborso completo se non arriva alcun codice.
Come evitare di addebitare due volte un cliente in caso di ripetizione?
Invia un'intestazione Idempotency-Key su POST /otp-numbers. Ritentare la stessa richiesta con la stessa chiave restituisce l'ordine originale invece di crearne uno nuovo.
Posso ricevere eventi di consegna in tempo reale invece di fare polling?
Sì. Registra un endpoint webhook e ricevi eventi otp.completed firmati nel momento in cui accadono, invece di fare polling.
Quali servizi sono supportati tramite l'API?
Oltre 80 servizi tra cui WhatsApp, Telegram, Google, Instagram, Facebook, Discord e altri. Chiama GET /otp-catalog per la lista aggiornata.
Inizia a rivendere numeri OTP oggi stesso
Crea un account gratuito, genera la tua chiave API e fornisci il tuo primo numero OTP in pochi minuti.