Portare il codice SMS di Mercado Pago nella tua esecuzione di test

Quale problema risolvono i team al passaggio del telefono di Mercado Pago?

Mercado Pago, la piattaforma di pagamenti e portafoglio digitale di Mercado Libre, fa parte del commercio quotidiano in America Latina. Come la maggior parte delle app finanziarie, collega un account a un numero di telefono: un codice SMS conferma il numero alla registrazione, e l'app può chiedere un nuovo codice quando qualcuno accede da un nuovo dispositivo o recupera l'accesso. Per i team che ci costruiscono attorno, come i commercianti che configurano il checkout, le agenzie che gestiscono l'account venditore di un cliente o gli ingegneri QA che testano un marketplace che offre Mercado Pago al pagamento, quel passaggio SMS è spesso il punto scomodo. Il personale finisce per mettere numeri di telefono personali su account aziendali, oppure un caso di test si blocca perché l'unica persona con la SIM giusta è offline.

OTP Route trasforma questo passaggio in qualcosa che i tuoi strumenti sanno gestire: un numero su richiesta per il mercato che ti serve, con il codice consegnato ai tuoi sistemi. È il cuore della verifica SMS di Mercado Pago per i test.

Come funziona il flusso dell'API del codice di verifica Mercado Pago?

Tutte le richieste vanno a https://otproute.com/api/v1 con una chiave Bearer (prefisso or_live_) della Developer console. L'id del servizio è mercado_pago; l'id del paese è il valore api_country del tuo mercato, per esempio br per il Brasile o mx per il Messico.

1. GET /api/v1/prices?country=br&service=mercado_pago restituisce prezzo e disponibilità in tempo reale per quella combinazione.
2. POST /api/v1/activations con {"service": "mercado_pago", "country": "br"} restituisce l'id dell'attivazione e il numero.
3. Inserisci il numero nel passaggio del telefono dell'account che stai configurando o testando.
4. Recupera il codice quando activation.sms_received raggiunge il tuo endpoint, oppure facendo polling su GET /api/v1/activations/{id}.
5. Se l'esecuzione termina in anticipo, chiama POST /api/v1/activations/{id}/cancel.

Usa GET /api/v1/balance come controllo preliminare. Ogni account ha 10 chiavi, 5 endpoint webhook e 300 richieste al minuto; tutto il resto è nella documentazione.

Come dovrebbe gestire il gestore webhook i codici di Mercado Pago?

La consegna push evita che i test runner girino in cicli di polling. Ogni evento arriva con X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcola l'HMAC-SHA256 di <t>.<raw body> con il segreto dell'endpoint, confronta in tempo costante e scarta le richieste con timestamp vecchi. Poi rendi il gestore idempotente: salva l'id dell'attivazione e ignora una seconda consegna dello stesso evento, perché i nuovi tentativi capitano. Ascolta anche activation.expired e activation.cancelled, così il runner può liberare il suo slot e segnalare il test per un altro tentativo. Se preferisci non ospitare un endpoint, fare polling dell'attivazione ogni pochi secondi resta ben entro il limite di frequenza. La guida su come proteggere i webhook OTP ha una checklist più completa.

Da quale paese deve arrivare il numero Mercado Pago?

Il servizio mercado_pago è elencato in 201 paesi su OTP Route, ma la scelta utile è quasi sempre il mercato a cui appartiene l'account. Mercado Pago è più noto in Brasile, Argentina, Messico, Cile, Colombia, Uruguay e Perù, ed è lì che si trova la maggior parte dei casi di test. Il catalogo raggiunge anche Ecuador, Bolivia, Paraguay, Costa Rica, Panama, Repubblica Dominicana, Spagna, Portogallo e Stati Uniti, tra molti altri.

Un numero del paese sbagliato può fallire la validazione o far scattare controlli aggiuntivi, e non ti dice nulla su come gli utenti reali di quel mercato vivono il flusso. Fai combaciare il caso di test: l'onboarding brasiliano richiede un numero brasiliano, quello cileno un numero cileno.

Che cosa posso fare invece dalla dashboard?

Chi non sviluppa ottiene lo stesso risultato senza codice. Apri l'OTP Gateway, scegli Mercado Pago come servizio, scegli il paese e controlla il prezzo mostrato prima di ordinare. Copia il numero nell'app, richiedi l'SMS e il codice compare sulla scheda dell'attivazione appena viene consegnato. Il numero resta riservato per 20 minuti; se non arriva nulla, non viene addebitato nulla, perché l'importo torna automaticamente sul wallet.

Perché un codice Mercado Pago potrebbe non arrivare?

Le piattaforme di pagamento sono caute con i numeri di telefono, e un numero virtuale per Mercado Pago può essere rifiutato in alcuni o in tutti i flussi. Anche le rotte cambiano nel corso della giornata. Se il codice non compare:

• Lascia finire la finestra di 20 minuti; il rimborso è automatico.
• Evita di riordinare a raffica. Distanzia i tentativi o torna più tardi.
• Prova un'altra rotta per lo stesso mercato se una continua a scadere.
• Controlla che il campo del telefono abbia ricevuto il numero nel formato che l'app si aspetta.

Quando un flusso rifiuta sistematicamente i numeri virtuali, accetta il risultato e usa una linea reale per quell'account. La guida su come ridurre le consegne OTP fallite copre la diagnosi più in generale.

Quando ha più senso un Dedicated Number?

Un numero monouso gestisce un solo codice. Un account aziendale che chiederà un nuovo codice tra qualche mese ha bisogno di un numero che controlli ancora. I Dedicated Numbers di OTP Route svolgono questo ruolo negli Stati Uniti e in Canada, da $1.95/month: SMS in entrata nella dashboard e sul tuo webhook (number.sms_received), SMS in uscita e chiamate dal browser, con rinnovo dal wallet finché non rilasci la linea. Fuori da questi due paesi non esiste una linea a lungo termine self-service; scrivi a [email protected] per chiedere, con una disponibilità che dipende dalle norme locali. Vedi i numeri virtuali per i dettagli.

Quali regole valgono usando questi numeri con Mercado Pago?

Mercado Pago muove denaro reale e i suoi controlli di identità esistono per buoni motivi. Un numero di telefono di OTP Route non sostituisce quei controlli e non deve mai servire ad aggirarli: completa la verifica dell'identità con dati autentici, mantieni un account per ogni persona o azienda reale e rispetta i termini di Mercado Pago insieme all'Acceptable Use Policy di OTP Route. La piattaforma serve a testare il tuo prodotto e a gestire i tuoi account legittimi, non ad aprire account in serie o a riscuotere promozioni. La fatturazione è a consumo da un wallet USD prepagato (carta o USDT/USDC, con una fattura PDF per ogni ricarica), e su richiesta è disponibile una sandbox con codici simulati per i test di integrazione. Mercado Pago è un marchio del suo proprietario e OTP Route non è affiliata ad esso.

Domande frequenti

Posso ricevere un OTP Mercado Pago senza una SIM locale in Brasile o Messico?

Sì, se stai testando o gestendo il tuo account. Ordina un numero mercado_pago per il paese giusto e leggi il codice dalla dashboard, dall'API o da un webhook.

Qual è l'id del servizio Mercado Pago nell'API?

È mercado_pago. Combinalo con l'id del paese nel corpo di POST /api/v1/activations.

Mercado Pago accetta i numeri virtuali?

Non sempre. Può rifiutarli per alcuni flussi, ed è per questo che l'intero importo viene rimborsato quando nessun codice arriva entro 20 minuti.

Quanto costa un numero di telefono Mercado Pago per la verifica?

Da $0.20 per codice. Il prezzo esatto dipende dal paese ed è mostrato dall'API e dalla dashboard prima dell'ordine.

Posso usare lo stesso numero monouso per accedere di nuovo il mese prossimo?

No. Un numero monouso riceve un solo codice. Gli account che richiedono accessi ripetuti sono serviti meglio da un Dedicated Number statunitense o canadese.

La mia pipeline CI può provare il flusso Mercado Pago senza addebiti reali?

Sì. Richiedi la modalità sandbox per un account di sviluppo; restituisce numeri e codici simulati tramite gli stessi endpoint.

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.