Obsługa weryfikacji SMS Mercado Libre w testach i procesach operacyjnych

Sytuacja: budowanie na marketplace obejmującym wiele serwisów

Mercado Libre prowadzi osobne serwisy regionalne w całej Ameryce Łacińskiej, a integrację dla sprzedawców, panel logistyczny czy narzędzie do monitorowania cen często trzeba przetestować na kilku z nich. Każde konto testowe jest powiązane z krajem i w końcu prosi o numer telefonu. Zespoły polegające na telefonach pracowników kończą z prywatnymi numerami przypisanymi do kont firmowych i testami zablokowanymi do czasu, aż obudzi się odpowiednia osoba.

Numer wirtualny dla Mercado Libre od OTP Route daje QA i operacjom czystszą ścieżkę: numer na właściwym rynku, kod przechwycony przez API i żadnej prywatnej karty SIM. Zespoły marketplace'ów przeczytają więcej na stronie marketplace'y.

Kiedy Mercado Libre prosi o numer telefonu?

Jak większość dużych marketplace'ów, Mercado Libre używa weryfikacji telefonicznej w kilku przewidywalnych momentach: przy tworzeniu konta, przy logowaniu z nieznanego urządzenia, podczas odzyskiwania konta i przy zmianie danych bezpieczeństwa. SMS zawiera krótki kod liczbowy, zwykle po hiszpańsku, a w serwisie brazylijskim, Mercado Livre, po portugalsku. Twój test powinien wyodrębniać cyfry, a nie dopasowywać treść wiadomości, ponieważ jej brzmienie może się zmienić w każdej chwili.

Z jakich krajów można uzyskać numer telefonu dla Mercado Libre?

Usługa mercado jest obecnie dostępna na trasach w 201 krajach. Te, po które sięga większość zespołów, odpowiadają zasięgowi samego marketplace'u: Argentyna, Brazylia, Meksyk, Kolumbia, Chile, Urugwaj, Peru, Ekwador, Boliwia, Paragwaj, Wenezuela, Kostaryka, Panama, Gwatemala, Salwador, Honduras, Dominikana i Stany Zjednoczone.

Wybór kraju nie jest kosmetyczny. Konto zarejestrowane w jednym serwisie regionalnym zazwyczaj oczekuje numeru z tego rynku, więc wybierz trasę zgodną z przypadkiem testowym. Dostępność zmienia się w ciągu dnia; przed każdym uruchomieniem sprawdź GET /api/v1/countries.

Jak działa API kodów weryfikacyjnych Mercado Libre?

Użyj klucza Bearer z konsoli deweloperskiej (prefiks or_live_) względem https://otproute.com/api/v1:

1. Sprawdź cenę, na przykład GET /api/v1/prices?country=ar&service=mercado.
2. Utwórz aktywację przez POST /api/v1/activations z ciałem {"service": "mercado", "country": "ar"}.
3. Wpisz zwrócony numer na ekranie weryfikacji Mercado Libre.
4. Odbierz zdarzenie activation.sms_received albo odpytuj GET /api/v1/activations/{id}.

Przy webhookach waliduj X-OTPRoute-Signature (HMAC-SHA256 z <t>.<raw body> i sekretem endpointu), odrzucaj stare znaczniki czasu i zadbaj o idempotentność handlera: opieraj się na identyfikatorze aktywacji, aby ponowne dostarczenie nie wysłało tego samego kodu dwa razy. Odpytywanie pasuje do krótkich skryptów, webhooki do CI. Zaplanuj macierz testów marketplace'u z uwzględnieniem limitów na konto: 10 kluczy, 5 endpointów webhook, 300 żądań na minutę. Zobacz dokumentację i przechwytywanie OTP przez webhook.

Bez integracji? W panelu wybierz Mercado Libre i kraj, złóż zamówienie, wklej numer i poczekaj na kod na ekranie.

Dlaczego kod Mercado Libre może nie dotrzeć?

Marketplace'y starannie chronią rejestrację i logowanie, a Mercado Libre może odrzucać niektóre numery wirtualne. Dostarczenie zależy też od trasy i chwili. Każda aktywacja ma okno 20 minut: jeśli SMS nie dotrze albo anulujesz, cała opłata automatycznie wraca do portfela.

• Poczekaj na koniec okna, zanim spróbujesz ponownie.
• Spróbuj później albo przełącz się na inną trasę krajową, która nadal pasuje do testu.
• Zachowaj odstępy między próbami zamiast ponawiać zamówienia w pętli.

Więcej znajdziesz w artykule ograniczanie nieudanych dostaw OTP.

Kiedy lepszy jest numer dedykowany?

Numery z bramki obsługują po jednej weryfikacji. Jeśli konto wewnętrzne ma zalogować się ponownie po tygodniach, na przykład login operacyjny, który Mercado Libre weryfikuje ponownie na nowych urządzeniach, stała linia pozwala nie stracić dostępu. Numery dedykowane są oferowane tylko w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc, z przychodzącymi SMS-ami w panelu i na Twoim webhooku. Pasują do kont, które już akceptują numer amerykański lub kanadyjski; w przypadku innych rynków napisz na [email protected], aby zapytać, co jest możliwe.

Odpowiedzialne korzystanie i rozliczenia

OTP Route służy do testowania własnego produktu i prowadzenia legalnych kont. Przestrzegaj regulaminu Mercado Libre, utrzymuj jedno konto na realną osobę lub firmę i nigdy nie używaj numerów do tworzenia zduplikowanych profili sprzedawcy ani wielokrotnego odbierania promocji. Obowiązuje Acceptable Use Policy, a Mercado Libre jest znakiem towarowym swojego właściciela, bez sugerowania jakichkolwiek powiązań.

Płatność odbywa się z przedpłaconego portfela w USD, bez opłaty miesięcznej, zasilanego kartą lub USDT/USDC, z fakturą PDF za każde doładowanie. Poproś wsparcie o przeniesienie konta deweloperskiego do sandboxa, jeśli chcesz mieć symulowane kody Mercado Libre podczas budowania integracji.

Najczęstsze pytania

Czy mogę odebrać OTP Mercado Libre przez API?

Tak. Utwórz aktywację z usługą mercado i identyfikatorem kraju, a następnie odczytaj kod przez odpytywanie lub webhook activation.sms_received.

Jaki kraj wybrać dla konta testowego Mercado Libre?

Wybierz rynek, na którym zarejestrowano konto, na przykład Argentynę, Brazylię lub Meksyk, aby numer odpowiadał temu, czego oczekuje dany serwis regionalny.

Czy Mercado Libre akceptuje numery wirtualne?

Nie zawsze. Jeśli kod nie dotrze w ciągu 20 minut, kwota jest zwracana i możesz spróbować później lub inną trasą.

Ile kosztuje weryfikacja SMS Mercado Libre do testów?

Od $0.20 za kod; dokładna cena zależy od kraju i jest pokazywana przez GET /api/v1/prices przed zamówieniem.

Czy mogę zachować ten sam numer do przyszłych logowań w Mercado Libre?

Numery z bramki są jednorazowe. Numer dedykowany w USA lub Kanadzie można zachować, dopóki się odnawia, jeśli konto akceptuje taki numer.

Jak zapobiec dwukrotnemu przetworzeniu tego samego kodu przez mój webhook?

Zapisz identyfikator aktywacji, gdy nadejdzie pierwsze zdarzenie, i po weryfikacji podpisu ignoruj powtórzenia dla tego identyfikatora.

Czy mogę otworzyć kilka kont Mercado Libre na numerach OTP Route?

Tylko wtedy, gdy każde konto należy do realnej osoby lub firmy, a regulamin Mercado Libre na to pozwala. Konta zduplikowane lub promocyjne są niedozwolone.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.