Gestire la verifica SMS di Mercado Libre nei flussi di test e operativi

La situazione: sviluppare su un marketplace con tanti siti

Mercado Libre gestisce siti regionali separati in tutta l'America Latina, e un'integrazione per venditori, una dashboard logistica o uno strumento di monitoraggio dei prezzi spesso devono essere testati su più di essi. Ogni account di test è legato a un paese e, prima o poi, ognuno chiede un numero di telefono. I team che si affidano ai telefoni dei dipendenti finiscono con numeri personali collegati ad account aziendali e con test bloccati in attesa di chi è sveglio.

Un numero virtuale per Mercado Libre di OTP Route offre a QA e operazioni un percorso più pulito: un numero nel mercato giusto, un codice catturato via API e nessuna SIM personale coinvolta. I team dei marketplace possono approfondire nella pagina marketplace.

Quando Mercado Libre chiede un numero di telefono?

Come la maggior parte dei grandi marketplace, Mercado Libre usa la verifica telefonica in alcuni momenti prevedibili: quando si crea un account, quando qualcuno accede da un dispositivo sconosciuto, durante il recupero dell'account e quando vengono modificati i dati di sicurezza. L'SMS contiene un breve codice numerico, di solito in spagnolo, oppure in portoghese sul sito brasiliano, Mercado Livre. Il tuo test dovrebbe estrarre le cifre invece di cercare il testo del messaggio, perché la formulazione può cambiare in qualsiasi momento.

Quali paesi possono fornire un numero di telefono per Mercado Libre?

Il servizio mercado è al momento disponibile su rotte in 201 paesi. Quelli che la maggior parte dei team sceglie rispecchiano la presenza del marketplace: Argentina, Brasile, Messico, Colombia, Cile, Uruguay, Perù, Ecuador, Bolivia, Paraguay, Venezuela, Costa Rica, Panama, Guatemala, El Salvador, Honduras, Repubblica Dominicana e Stati Uniti.

La scelta del paese non è un dettaglio estetico. Un account registrato su un sito regionale di norma si aspetta un numero di quel mercato, quindi scegli la rotta che corrisponde al caso di test. La disponibilità cambia nel corso della giornata; controlla GET /api/v1/countries prima di ogni esecuzione.

Come funziona l'API del codice di verifica Mercado Libre?

Usa una chiave Bearer della Developer console (prefisso or_live_) su https://otproute.com/api/v1:

1. Controlla il prezzo, per esempio GET /api/v1/prices?country=ar&service=mercado.
2. Crea l'attivazione con POST /api/v1/activations e {"service": "mercado", "country": "ar"}.
3. Inserisci il numero restituito nella schermata di verifica di Mercado Libre.
4. Ricevi l'evento activation.sms_received, oppure fai polling su GET /api/v1/activations/{id}.

Per i webhook, convalida X-OTPRoute-Signature (HMAC-SHA256 di <t>.<raw body> con il segreto dell'endpoint), rifiuta i timestamp vecchi e rendi il gestore idempotente: usa come chiave l'id dell'attivazione, così una consegna ritentata non può inviare due volte lo stesso codice. Il polling è adatto a script brevi; i webhook alla CI. Imposta la tua matrice di test sul marketplace tenendo conto dei limiti per account: 10 chiavi, 5 endpoint webhook, 300 richieste al minuto. Vedi la documentazione e la guida alla cattura degli OTP via webhook.

Nessuna integrazione? Nella dashboard scegli Mercado Libre e un paese, ordina, incolla il numero e attendi il codice a schermo.

Perché un codice Mercado Libre potrebbe non arrivare?

I marketplace proteggono con attenzione registrazione e accesso, e Mercado Libre può rifiutare alcuni numeri virtuali. La consegna dipende inoltre dalla rotta e dal momento. Ogni attivazione ha una finestra di 20 minuti: se non arriva alcun SMS, o se annulli, l'intero addebito torna automaticamente sul tuo wallet.

• Aspetta la fine della finestra prima di riprovare.
• Riprova più tardi, oppure passa a un'altra rotta di paese che sia ancora coerente con il tuo test.
• Lascia passare del tempo tra un tentativo e l'altro invece di riordinare in loop.

La guida sul ridurre le consegne OTP fallite approfondisce l'argomento.

Quando è più adatto un Dedicated Number?

I numeri del gateway gestiscono una sola verifica ciascuno. Se un account interno deve accedere di nuovo dopo settimane, per esempio un accesso operativo che Mercado Libre ricontrolla su nuovi dispositivi, una linea persistente evita di perdere l'accesso. I Dedicated Virtual Numbers sono offerti solo negli Stati Uniti e in Canada, da $1.95/month, con SMS in entrata nella dashboard e sul tuo webhook. Sono adatti ad account che accettano già un numero statunitense o canadese; per gli altri mercati scrivi a [email protected] per chiedere che cosa è possibile.

Uso responsabile e fatturazione

OTP Route serve a testare il tuo prodotto e a gestire account legittimi. Rispetta i termini di Mercado Libre, mantieni un account per ogni persona o azienda reale e non usare mai i numeri per creare profili venditore duplicati o per riscuotere ripetutamente promozioni. Si applica l'Acceptable Use Policy, e Mercado Libre è un marchio del suo proprietario, senza alcuna affiliazione implicita.

Il pagamento avviene con un wallet USD prepagato senza canone mensile, ricaricabile con carta o USDT/USDC, con una fattura PDF per ogni ricarica. Chiedi al supporto di spostare un account di sviluppo in sandbox se vuoi codici Mercado Libre simulati mentre colleghi l'integrazione.

Domande frequenti

Posso ricevere un OTP Mercado Libre tramite API?

Sì. Crea un'attivazione con il servizio mercado e un id paese, poi leggi il codice con il polling o con il webhook activation.sms_received.

Quale paese devo scegliere per un account di test Mercado Libre?

Scegli il mercato su cui l'account è registrato, come Argentina, Brasile o Messico, così il numero corrisponde a ciò che quel sito regionale si aspetta.

Mercado Libre accetta i numeri virtuali?

Non sempre. Se un codice non arriva entro 20 minuti, l'importo viene rimborsato e puoi riprovare più tardi o su un'altra rotta.

Quanto costa la verifica SMS di Mercado Libre per i test?

Da $0.20 per codice; il prezzo esatto dipende dal paese ed è mostrato da GET /api/v1/prices prima dell'ordine.

Posso tenere lo stesso numero per i futuri accessi a Mercado Libre?

I numeri del gateway sono monouso. Un Dedicated Number negli Stati Uniti o in Canada può essere mantenuto finché si rinnova, se l'account accetta un numero del genere.

Come evito che il mio webhook elabori due volte lo stesso codice?

Salva l'id dell'attivazione quando arriva il primo evento e, dopo aver verificato la firma, ignora le ripetizioni per quell'id.

Posso aprire più account Mercado Libre con i numeri di OTP Route?

Solo se ogni account appartiene a una persona o azienda reale e i termini di Mercado Libre lo consentono. Gli account duplicati o promozionali non sono ammessi.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.