Jak wprowadzić kod SMS Mercado Pago do swojego uruchomienia testów

Jaki problem rozwiązują zespoły w kroku z telefonem w Mercado Pago?

Mercado Pago, platforma płatnicza i portfel cyfrowy z grupy Mercado Libre, jest częścią codziennego handlu w całej Ameryce Łacińskiej. Jak większość aplikacji finansowych, wiąże konto z numerem telefonu: kod SMS potwierdza numer przy rejestracji, a aplikacja może poprosić o świeży kod przy logowaniu na nowym urządzeniu lub odzyskiwaniu dostępu. Dla zespołów budujących wokół niej, takich jak sprzedawcy wdrażający checkout, agencje prowadzące konto sprzedawcy klienta czy inżynierowie QA testujący marketplace oferujący Mercado Pago przy płatności, ten krok SMS bywa najbardziej kłopotliwy. Pracownicy wpisują prywatne numery do kont firmowych albo test staje, bo jedyna osoba z właściwą kartą SIM jest offline.

OTP Route zamienia ten krok w coś, co obsłużą Twoje narzędzia: numer na żądanie dla potrzebnego rynku, a kod dostarczony do Twoich systemów. To sedno weryfikacji SMS Mercado Pago do testów.

Jak działa przepływ API kodu weryfikacyjnego Mercado Pago?

Wszystkie żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer (prefiks or_live_) z konsoli deweloperskiej. Identyfikator usługi to mercado_pago; identyfikator kraju to wartość api_country dla Twojego rynku, na przykład br dla Brazylii lub mx dla Meksyku.

1. GET /api/v1/prices?country=br&service=mercado_pago zwraca aktualną cenę i dostępność dla tej pary.
2. POST /api/v1/activations z ciałem {"service": "mercado_pago", "country": "br"} zwraca identyfikator aktywacji i numer.
3. Wpisz numer w kroku z telefonem w koncie, które zakładasz lub testujesz.
4. Odbierz kod, gdy activation.sms_received dotrze do Twojego endpointu, albo odpytując GET /api/v1/activations/{id}.
5. Jeśli uruchomienie zakończy się wcześniej, wywołaj POST /api/v1/activations/{id}/cancel.

Użyj GET /api/v1/balance jako kontroli przed startem. Każde konto ma 10 kluczy, 5 endpointów webhook i 300 żądań na minutę; resztę znajdziesz w dokumentacji.

Jak handler webhooka powinien traktować kody Mercado Pago?

Dostarczanie push chroni test runnery przed kręceniem się w pętlach odpytywania. Każde zdarzenie przychodzi z X-OTPRoute-Signature: t=<unix>,v1=<hex>; oblicz HMAC-SHA256 z <t>.<raw body> przy użyciu sekretu endpointu, porównaj w stałym czasie i odrzucaj żądania ze starymi znacznikami czasu. Następnie zadbaj o idempotentność handlera: zapisz identyfikator aktywacji i ignoruj drugie dostarczenie tego samego zdarzenia, bo ponowienia się zdarzają. Nasłuchuj też activation.expired i activation.cancelled, aby runner mógł zwolnić slot i oznaczyć test do ponownej próby. Jeśli nie chcesz hostować endpointu, odpytywanie aktywacji co kilka sekund mieści się z dużym zapasem w limicie. Zabezpieczanie webhooków OTP zawiera pełniejszą listę kontrolną.

Z jakiego kraju powinien pochodzić numer dla Mercado Pago?

Usługa mercado_pago jest wymieniona w 201 krajach w OTP Route, ale sensowny wybór to prawie zawsze rynek, do którego należy konto. Mercado Pago jest najbardziej znane w Brazylii, Argentynie, Meksyku, Chile, Kolumbii, Urugwaju i Peru, więc tam żyje większość przypadków testowych. Katalog obejmuje też Ekwador, Boliwię, Paragwaj, Kostarykę, Panamę, Dominikanę, Hiszpanię, Portugalię i Stany Zjednoczone, a także wiele innych.

Numer z niewłaściwego kraju może nie przejść walidacji albo wywołać dodatkowe kontrole, a nie mówi nic o tym, jak proces odbierają prawdziwi użytkownicy na danym rynku. Dopasuj numer do przypadku testowego: brazylijski onboarding dostaje brazylijski numer, chilijski – chilijski.

Co mogę zrobić zamiast tego z panelu?

Osoby niebędące programistami osiągają ten sam efekt bez kodu. Otwórz OTP Gateway, wybierz Mercado Pago jako usługę, wybierz kraj i sprawdź cenę wyświetlaną przed zamówieniem. Skopiuj numer do aplikacji, poproś o SMS, a kod pojawi się na karcie aktywacji zaraz po dostarczeniu. Numer jest utrzymywany przez 20 minut; jeśli nic nie dotrze, nic nie jest pobierane, bo kwota automatycznie wraca do portfela.

Dlaczego kod Mercado Pago może nie dotrzeć?

Platformy płatnicze uważnie traktują numery telefonów, a numer wirtualny dla Mercado Pago może zostać odrzucony w niektórych lub we wszystkich procesach. Trasy zmieniają się też w ciągu dnia. Jeśli kod się nie pojawia:

• Poczekaj na koniec 20-minutowego okna; zwrot jest automatyczny.
• Unikaj ponownego zamawiania w ciasnej pętli. Rozłóż próby w czasie lub wróć później.
• Spróbuj innej trasy dla tego samego rynku, jeśli jedna stale wygasa.
• Sprawdź, czy pole telefonu otrzymało numer w formacie, którego oczekuje aplikacja.

Gdy proces konsekwentnie odrzuca numery wirtualne, zaakceptuj ten wynik i użyj dla tego konta prawdziwej linii. Ograniczanie nieudanych dostaw OTP opisuje szerszą diagnostykę.

Kiedy bardziej sensowny jest numer dedykowany?

Numer jednorazowy obsługuje jeden kod. Konto firmowe, które za kilka miesięcy poprosi o świeży kod, potrzebuje numeru, który nadal kontrolujesz. Numery dedykowane OTP Route pełnią tę rolę w Stanach Zjednoczonych i Kanadzie, od $1.95/miesiąc: przychodzące SMS-y w panelu i na Twoim webhooku (number.sms_received), wychodzące SMS-y i połączenia z przeglądarki, odnawiane z portfela, dopóki nie zwolnisz linii. Poza tymi dwoma krajami nie ma samoobsługowej linii długoterminowej; napisz na [email protected], aby zapytać, przy czym dostępność zależy od lokalnych przepisów. Szczegóły na stronie numery wirtualne.

Jakie zasady obowiązują przy używaniu tych numerów z Mercado Pago?

Mercado Pago operuje prawdziwymi pieniędzmi, a jego kontrole tożsamości mają dobre powody. Numer z OTP Route nie zastępuje tych kontroli i nigdy nie wolno używać go do ich omijania: przejdź weryfikację tożsamości z prawdziwymi danymi, utrzymuj jedno konto na realną osobę lub firmę i przestrzegaj regulaminu Mercado Pago oraz Acceptable Use Policy OTP Route. Platforma służy do testowania własnego produktu i prowadzenia własnych legalnych kont, a nie do masowego otwierania kont czy odbierania promocji. Rozliczenia działają w modelu pay as you go z przedpłaconego portfela w USD (karta lub USDT/USDC, z fakturą PDF za każde doładowanie), a sandbox z symulowanymi kodami jest dostępny na prośbę do testów integracji. Mercado Pago jest znakiem towarowym swojego właściciela, a OTP Route nie jest z nim powiązany.

Najczęstsze pytania

Czy mogę odebrać OTP Mercado Pago bez lokalnej karty SIM w Brazylii lub Meksyku?

Tak, gdy testujesz lub obsługujesz własne konto. Zamów numer mercado_pago dla właściwego kraju i odczytaj kod z panelu, API lub webhooka.

Jaki jest identyfikator usługi Mercado Pago w API?

To mercado_pago. Połącz go z identyfikatorem kraju w ciele POST /api/v1/activations.

Czy Mercado Pago akceptuje numery wirtualne?

Nie zawsze. W niektórych procesach może je odrzucać, dlatego cała kwota jest zwracana, gdy kod nie dotrze w ciągu 20 minut.

Ile kosztuje numer telefonu do weryfikacji Mercado Pago?

Od $0.20 za kod. Dokładna cena zależy od kraju i jest pokazywana przez API oraz panel przed zamówieniem.

Czy mogę użyć tego samego numeru jednorazowego do ponownego logowania w przyszłym miesiącu?

Nie. Numer jednorazowy odbiera pojedynczy kod. Konta wymagające powtarzanych logowań lepiej obsłuży numer dedykowany z USA lub Kanady.

Czy mój potok CI może przećwiczyć proces Mercado Pago bez prawdziwych opłat?

Tak. Poproś o tryb sandbox dla konta deweloperskiego; zwraca symulowane numery i kody przez te same endpointy.

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.