Faire arriver un code SMS Mercado Pago dans votre exécution de tests

Quel problème les équipes résolvent-elles à l'étape téléphone de Mercado Pago ?

Mercado Pago, la plateforme de paiement et de portefeuille numérique de Mercado Libre, fait partie du commerce quotidien en Amérique latine. Comme la plupart des applications financières, elle lie un compte à un numéro de téléphone : un code SMS confirme le numéro à l'inscription, et l'application peut demander un nouveau code lors d'une connexion sur un nouvel appareil ou d'une récupération d'accès. Pour les équipes qui construisent autour de cette plateforme, comme les marchands qui intègrent le paiement, les agences qui gèrent le compte vendeur d'un client ou les ingénieurs QA qui testent une place de marché proposant Mercado Pago au moment du paiement, cette étape SMS est souvent la plus pénible. Les collaborateurs finissent par mettre leurs numéros personnels sur des comptes professionnels, ou un cas de test reste bloqué parce que la seule personne qui détient la bonne SIM est hors ligne.

OTP Route transforme cette étape en quelque chose que vos outils peuvent gérer : un numéro à la demande pour le marché voulu, avec le code livré à vos systèmes. C'est le cœur de la vérification SMS Mercado Pago pour les tests.

Comment fonctionne le flux de l'API de code de vérification Mercado Pago ?

Toutes les requêtes ciblent https://otproute.com/api/v1 avec une clé Bearer (préfixe or_live_) issue de la console Développeur. L'identifiant du service est mercado_pago ; l'identifiant du pays est la valeur api_country de votre marché, par exemple br pour le Brésil ou mx pour le Mexique.

1. GET /api/v1/prices?country=br&service=mercado_pago renvoie le tarif en direct et la disponibilité pour cette combinaison.
2. POST /api/v1/activations avec {"service": "mercado_pago", "country": "br"} renvoie l'identifiant d'activation et le numéro.
3. Saisissez le numéro à l'étape du téléphone du compte que vous configurez ou testez.
4. Récupérez le code lorsque activation.sms_received parvient à votre endpoint, ou en interrogeant GET /api/v1/activations/{id}.
5. Si l'exécution s'arrête plus tôt, appelez POST /api/v1/activations/{id}/cancel.

Utilisez GET /api/v1/balance comme contrôle préalable. Chaque compte dispose de 10 clés, 5 endpoints de webhook et 300 requêtes par minute ; tout le reste figure dans la documentation.

Comment le gestionnaire de webhook doit-il traiter les codes Mercado Pago ?

La livraison en push évite que les exécuteurs de tests tournent en boucles d'interrogation. Chaque événement arrive avec X-OTPRoute-Signature: t=<unix>,v1=<hex> ; calculez le HMAC-SHA256 de <t>.<raw body> avec le secret du endpoint, comparez en temps constant et écartez les requêtes dont l'horodatage est ancien. Rendez ensuite le gestionnaire idempotent : enregistrez l'identifiant d'activation et ignorez une seconde livraison du même événement, car les renvois existent. Écoutez aussi activation.expired et activation.cancelled, pour que l'exécuteur libère sa place et marque le test pour une nouvelle tentative. Si vous préférez ne pas héberger de endpoint, interroger l'activation toutes les quelques secondes reste largement dans la limite de débit. Sécuriser les webhooks d'OTP propose une checklist plus complète.

De quel pays doit venir le numéro Mercado Pago ?

Le service mercado_pago est référencé dans 201 pays sur OTP Route, mais le choix utile est presque toujours le marché auquel appartient le compte. Mercado Pago est surtout connu au Brésil, en Argentine, au Mexique, au Chili, en Colombie, en Uruguay et au Pérou ; c'est donc là que se situent la plupart des cas de test. Le catalogue couvre aussi l'Équateur, la Bolivie, le Paraguay, le Costa Rica, le Panama, la République dominicaine, l'Espagne, le Portugal et les États-Unis, entre autres.

Un numéro du mauvais pays peut échouer à la validation ou déclencher des contrôles supplémentaires, et il ne vous dit rien sur l'expérience réelle des utilisateurs de ce marché. Faites correspondre le cas de test : une inscription brésilienne reçoit un numéro brésilien, une inscription chilienne un numéro chilien.

Que puis-je faire depuis le tableau de bord à la place ?

Les non-développeurs obtiennent le même résultat sans code. Ouvrez l'OTP Gateway, choisissez Mercado Pago comme service, choisissez le pays et vérifiez le prix affiché avant de commander. Copiez le numéro dans l'application, demandez le SMS, et le code apparaît sur la carte d'activation dès qu'il est livré. Le numéro est conservé 20 minutes ; si rien n'arrive, rien n'est facturé, puisque le montant retourne automatiquement sur votre portefeuille.

Pourquoi un code Mercado Pago pourrait-il ne pas arriver ?

Les plateformes de paiement sont prudentes avec les numéros de téléphone, et un numéro virtuel pour Mercado Pago peut être refusé dans certains parcours, voire tous. Les routes évoluent aussi au fil de la journée. Si un code n'apparaît pas :

• Laissez la fenêtre de 20 minutes se terminer ; le remboursement est automatique.
• Évitez de recommander en boucle serrée. Espacez les tentatives ou revenez plus tard.
• Essayez une autre route pour le même marché si l'une expire systématiquement.
• Vérifiez que le champ téléphone a reçu le numéro dans le format attendu par l'application.

Lorsqu'un parcours rejette systématiquement les numéros virtuels, acceptez ce résultat et utilisez une vraie ligne pour ce compte. L'article réduire les échecs de livraison d'OTP couvre le diagnostic plus largement.

Quand un numéro dédié est-il plus pertinent ?

Un numéro à usage unique gère un seul code. Un compte professionnel qui demandera un nouveau code dans plusieurs mois a besoin d'un numéro que vous contrôlez encore. Les numéros dédiés d'OTP Route remplissent ce rôle aux États-Unis et au Canada, à partir de $1.95/mois : SMS entrants dans le tableau de bord et sur votre webhook (number.sms_received), SMS sortants et appels depuis le navigateur, avec un renouvellement depuis le portefeuille jusqu'à la libération de la ligne. En dehors de ces deux pays, il n'existe pas de ligne longue durée en libre-service ; écrivez à [email protected] pour poser la question, la disponibilité dépendant de la réglementation locale. Voir numéros virtuels pour plus de détails.

Quelles règles s'appliquent à l'usage de ces numéros avec Mercado Pago ?

Mercado Pago manipule de l'argent réel, et ses contrôles d'identité existent pour de bonnes raisons. Un numéro de téléphone OTP Route ne remplace pas ces contrôles et ne doit jamais servir à les contourner : réalisez la vérification d'identité avec des informations authentiques, conservez un compte par personne ou entreprise réelle et respectez les conditions de Mercado Pago ainsi que la politique d'utilisation acceptable d'OTP Route. La plateforme sert à tester votre propre produit et à exploiter vos propres comptes légitimes, pas à ouvrir des comptes en volume ni à réclamer des promotions. La facturation est à l'usage depuis un portefeuille prépayé en USD (carte ou USDT/USDC, avec une facture PDF pour chaque recharge), et un sandbox avec codes simulés est disponible sur demande pour les tests d'intégration. Mercado Pago est une marque de son propriétaire, et OTP Route n'y est pas affilié.

Questions fréquentes

Puis-je recevoir un OTP Mercado Pago sans SIM locale au Brésil ou au Mexique ?

Oui, lorsque vous testez ou exploitez votre propre compte. Commandez un numéro mercado_pago pour le bon pays et lisez le code dans le tableau de bord, via l'API ou par webhook.

Quel est l'identifiant du service Mercado Pago dans l'API ?

C'est mercado_pago. Associez-le à l'identifiant du pays dans le corps de POST /api/v1/activations.

Mercado Pago accepte-t-il les numéros virtuels ?

Pas toujours. Il peut les rejeter dans certains parcours, c'est pourquoi la totalité du montant est remboursée lorsqu'aucun code n'arrive en 20 minutes.

Combien coûte un numéro de téléphone pour la vérification Mercado Pago ?

À partir de $0.20 par code. Le prix exact dépend du pays et est affiché par l'API et le tableau de bord avant la commande.

Puis-je utiliser le même numéro à usage unique pour me reconnecter le mois prochain ?

Non. Un numéro à usage unique reçoit un seul code. Les comptes qui nécessitent des connexions répétées sont mieux servis par un numéro dédié américain ou canadien.

Mon pipeline CI peut-il exécuter le flux Mercado Pago sans frais réels ?

Oui. Demandez le mode sandbox sur un compte de développement : il renvoie des numéros et des codes simulés via les mêmes endpoints.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.