English
Handling Mercado Libre SMS Verification in Test and Ops Workflows
To receive a Mercado Libre verification code with OTP Route, order an OTP Gateway number for the service mercado in the country your account belongs to, enter it in Mercado Libre, and read the code in the dashboard or from the API and webhooks. Prices start at $0.20 per code, the number stays active for 20 minutes, and you only pay if the SMS arrives.
The situation: building on a marketplace that spans many sites
Mercado Libre runs separate regional sites across Latin America, and a seller integration, logistics dashboard or price-monitoring tool often has to be tested against several of them. Each test account is tied to a country, and each one eventually asks for a phone number. Teams that rely on staff phones end up with personal numbers attached to business accounts and test runs blocked on whoever is awake.
A virtual number for Mercado Libre from OTP Route gives QA and operations a cleaner path: a number in the right market, a code captured by API, and no personal SIM involved. Marketplace teams can read more in marketplaces.
When does Mercado Libre ask for a phone number?
Like most large marketplaces, Mercado Libre uses phone verification at a few predictable points: when an account is created, when someone signs in from an unfamiliar device, during account recovery, and when security details are changed. The SMS carries a short numeric code, usually in Spanish, or Portuguese on the Brazilian site, Mercado Livre. Your test should extract the digits rather than match on the message text, because wording can change at any time.
Which countries can supply a Mercado Libre phone number?
The mercado service is currently available on routes in 201 countries. The ones most teams reach for match the marketplace's own footprint: Argentina, Brazil, Mexico, Colombia, Chile, Uruguay, Peru, Ecuador, Bolivia, Paraguay, Venezuela, Costa Rica, Panama, Guatemala, El Salvador, Honduras, the Dominican Republic and the United States.
Country choice is not cosmetic. An account registered on one regional site generally expects a number from that market, so pick the route that matches the test case. Availability changes through the day; check GET /api/v1/countries before each run.
How does the Mercado Libre verification code API work?
Use a Bearer key from the Developer console (prefix or_live_) against https://otproute.com/api/v1:
- Check the price, for example
GET /api/v1/prices?country=ar&service=mercado. - Create the activation with
POST /api/v1/activationsand{"service": "mercado", "country": "ar"}. - Enter the returned number on the Mercado Libre verification screen.
- Receive the
activation.sms_receivedevent, or pollGET /api/v1/activations/{id}.
For webhooks, validate X-OTPRoute-Signature (HMAC-SHA256 of <t>.<raw body> with the endpoint secret), reject old timestamps, and make the handler idempotent: key on the activation id so a retried delivery cannot submit the same code twice. Polling suits short scripts; webhooks suit CI. Plan your marketplace test matrix around the per-account ceilings: 10 keys, 5 webhook endpoints, 300 requests a minute. See the docs and webhook-based OTP capture.
No integration? In the dashboard, choose Mercado Libre and a country, order, paste the number and wait for the code on screen.
Why might a Mercado Libre code not arrive?
Marketplaces protect sign-up and login carefully, and Mercado Libre may decline some virtual numbers. Delivery also depends on the route and the moment. Each activation has a 20-minute window: if no SMS arrives, or you cancel, the full charge goes back to your wallet automatically.
- Wait out the window before retrying.
- Try again later, or switch to another country route that still fits your test.
- Back off between attempts instead of reordering in a loop.
Reducing failed OTP deliveries goes deeper.
When is a Dedicated Number the better fit?
Gateway numbers handle one verification each. If an internal account has to sign in again weeks later, for example an operations login that Mercado Libre re-verifies on new devices, a persistent line avoids losing access. Dedicated Virtual Numbers are offered in the United States and Canada only, from $1.95/month, with inbound SMS in the dashboard and on your webhook. They suit accounts that already accept a US or Canadian number; for other markets, email [email protected] to ask what is possible.
Responsible use and billing
OTP Route is for testing your own product and operating legitimate accounts. Follow Mercado Libre's terms, keep one account per real person or business, and never use numbers to create duplicate seller profiles or claim promotions repeatedly. The Acceptable Use Policy applies, and Mercado Libre is a trademark of its owner, with no affiliation implied.
Payment is a prepaid USD wallet with no monthly fee, funded by card or USDT/USDC, with a PDF invoice per top-up. Ask support to move a development account into sandbox if you want simulated Mercado Libre codes while wiring up the integration.
Frequently asked questions
Can I receive a Mercado Libre OTP through an API?
Yes. Create an activation with service mercado and a country id, then read the code via polling or the activation.sms_received webhook.
Which country should I choose for a Mercado Libre test account?
Pick the market the account is registered on, such as Argentina, Brazil or Mexico, so the number matches what that regional site expects.
Does Mercado Libre accept virtual numbers?
Not always. If a code does not arrive within 20 minutes, the amount is refunded and you can try later or on another route.
How much does Mercado Libre SMS verification for testing cost?
From $0.20 per code; the exact price depends on the country and is shown by GET /api/v1/prices before you order.
Can I keep the same number for future Mercado Libre logins?
Gateway numbers are single-use. A Dedicated Number in the US or Canada can be kept while it renews, if the account accepts such a number.
How do I stop my webhook from processing the same code twice?
Store the activation id when the first event arrives and ignore repeats for that id after verifying the signature.
Can I open several Mercado Libre accounts with OTP Route numbers?
Only where each account belongs to a real person or business and Mercado Libre's terms allow it. Duplicate or promotional accounts are not permitted.
Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.