Einen Mercado-Pago-SMS-Code in Ihren Testlauf bringen

Welches Problem lösen Teams im Telefonschritt von Mercado Pago?

Mercado Pago, die Zahlungs- und Digital-Wallet-Plattform von Mercado Libre, gehört in ganz Lateinamerika zum Alltag des Handels. Wie die meisten Finanz-Apps bindet es ein Konto an eine Telefonnummer: Ein SMS-Code bestätigt die Nummer bei der Registrierung, und die App kann einen neuen Code verlangen, wenn sich jemand auf einem neuen Gerät anmeldet oder den Zugang wiederherstellt. Für Teams, die darauf aufbauen – Händler, die den Checkout anbinden, Agenturen, die das Verkäuferkonto eines Kunden betreiben, oder QA-Engineers, die einen Marktplatz testen, der Mercado Pago an der Kasse anbietet –, ist dieser SMS-Schritt oft die lästige Stelle. Mitarbeitende hinterlegen private Telefonnummern in Geschäftskonten, oder ein Testfall hängt, weil die einzige Person mit der richtigen SIM offline ist.

OTP Route macht daraus einen Schritt, den Ihr Tooling bewältigen kann: eine Nummer auf Abruf für den benötigten Markt, mit Zustellung des Codes an Ihre Systeme. Das ist der Kern der Mercado-Pago-SMS-Verifizierung für Tests.

Wie funktioniert der Ablauf der Mercado-Pago-Verifizierungscode-API?

Alle Anfragen gehen an https://otproute.com/api/v1 mit einem Bearer-Schlüssel (Präfix or_live_) aus der Developer-Konsole. Die Dienst-ID ist mercado_pago; die Länder-ID ist der api_country-Wert Ihres Marktes, zum Beispiel br für Brasilien oder mx für Mexiko.

1. GET /api/v1/prices?country=br&service=mercado_pago liefert den aktuellen Preis und die Verfügbarkeit für diese Kombination.
2. POST /api/v1/activations mit {"service": "mercado_pago", "country": "br"} gibt die Aktivierungs-ID und die Nummer zurück.
3. Geben Sie die Nummer im Telefonschritt des Kontos ein, das Sie einrichten oder testen.
4. Holen Sie den Code ab, wenn activation.sms_received Ihren Endpunkt erreicht, oder per Abfrage von GET /api/v1/activations/{id}.
5. Endet der Lauf vorzeitig, rufen Sie POST /api/v1/activations/{id}/cancel auf.

Nutzen Sie GET /api/v1/balance als Vorabprüfung. Jedes Konto erhält 10 Schlüssel, 5 Webhook-Endpunkte und 300 Anfragen pro Minute; alles Weitere steht in der Dokumentation.

Wie sollte der Webhook-Handler Mercado-Pago-Codes behandeln?

Push-Zustellung hält Test-Runner aus Polling-Schleifen heraus. Jedes Ereignis kommt mit X-OTPRoute-Signature: t=<unix>,v1=<hex>; berechnen Sie HMAC-SHA256 über <t>.<raw body> mit dem Endpoint-Secret, vergleichen Sie in konstanter Zeit und verwerfen Sie Anfragen mit alten Zeitstempeln. Machen Sie den Handler dann idempotent: Speichern Sie die Aktivierungs-ID und ignorieren Sie eine zweite Zustellung desselben Ereignisses, denn Wiederholungen kommen vor. Hören Sie auch auf activation.expired und activation.cancelled, damit der Runner seinen Slot freigeben und den Test für einen weiteren Versuch markieren kann. Möchten Sie keinen Endpunkt hosten, bleibt das Abfragen der Aktivierung alle paar Sekunden gut innerhalb des Ratenlimits. OTP-Webhooks absichern bietet eine ausführlichere Checkliste.

Aus welchem Land sollte die Mercado-Pago-Nummer stammen?

Der Dienst mercado_pago ist bei OTP Route in 201 Ländern gelistet, doch die sinnvolle Wahl ist fast immer der Markt, zu dem das Konto gehört. Mercado Pago ist vor allem in Brasilien, Argentinien, Mexiko, Chile, Kolumbien, Uruguay und Peru bekannt, dort liegen daher die meisten Testfälle. Der Katalog reicht außerdem unter anderem bis Ecuador, Bolivien, Paraguay, Costa Rica, Panama, die Dominikanische Republik, Spanien, Portugal und die Vereinigten Staaten.

Eine Nummer aus dem falschen Land kann die Validierung nicht bestehen oder zusätzliche Prüfungen auslösen und sagt nichts darüber aus, wie echte Nutzer in diesem Markt den Ablauf erleben. Passen Sie die Wahl dem Testfall an: Brasilianisches Onboarding bekommt eine brasilianische Nummer, chilenisches eine chilenische.

Was kann ich stattdessen im Dashboard tun?

Nicht-Entwickler erreichen dasselbe Ergebnis ohne Code. Öffnen Sie das OTP Gateway, wählen Sie Mercado Pago als Dienst, wählen Sie das Land und prüfen Sie den vor der Bestellung angezeigten Preis. Kopieren Sie die Nummer in die App, fordern Sie die SMS an, und der Code erscheint auf der Aktivierungskarte, sobald er zugestellt wird. Die Nummer wird 20 Minuten lang gehalten; kommt nichts an, wird nichts berechnet, da der Betrag automatisch ins Wallet zurückfließt.

Warum kommt ein Mercado-Pago-Code möglicherweise nicht an?

Zahlungsplattformen gehen sorgfältig mit Telefonnummern um, und eine virtuelle Nummer für Mercado Pago kann in einzelnen oder allen Abläufen abgelehnt werden. Auch Routen ändern sich im Tagesverlauf. Wenn kein Code erscheint:

• Lassen Sie das 20-Minuten-Fenster ablaufen; die Erstattung erfolgt automatisch.
• Vermeiden Sie Neubestellungen in enger Schleife. Verteilen Sie die Versuche oder kommen Sie später wieder.
• Probieren Sie eine andere Route für denselben Markt, wenn eine ständig abläuft.
• Prüfen Sie, ob das Telefonfeld die Nummer in dem Format erhalten hat, das die App erwartet.

Lehnt ein Ablauf virtuelle Nummern durchgehend ab, nehmen Sie dieses Ergebnis hin und nutzen für dieses Konto eine echte Leitung. Fehlgeschlagene OTP-Zustellungen reduzieren deckt die weitergehende Diagnose ab.

Wann ist eine Dedicated Number sinnvoller?

Eine Einmalnummer deckt einen Code ab. Ein Geschäftskonto, das in Monaten einen neuen Code verlangt, braucht eine Nummer, die Sie weiterhin kontrollieren. Die Dedicated Numbers von OTP Route erfüllen diese Rolle in den Vereinigten Staaten und Kanada ab $1.95/Monat: eingehende SMS im Dashboard und auf Ihrem Webhook (number.sms_received), ausgehende SMS und Browser-Telefonie, verlängert aus dem Wallet, bis Sie die Leitung freigeben. Außerhalb dieser beiden Länder gibt es keine Self-Service-Langzeitleitung; schreiben Sie an [email protected], um nachzufragen – die Verfügbarkeit hängt von lokalen Vorschriften ab. Details finden Sie unter virtuelle Nummern.

Welche Regeln gelten bei der Nutzung dieser Nummern mit Mercado Pago?

Mercado Pago bewegt echtes Geld, und seine Identitätsprüfungen haben gute Gründe. Eine Telefonnummer von OTP Route ersetzt diese Prüfungen nicht und darf nie dazu dienen, sie zu umgehen: Schließen Sie die Identitätsverifizierung mit echten Angaben ab, führen Sie ein Konto pro realer Person oder Unternehmen und halten Sie sich neben der Acceptable Use Policy von OTP Route an Mercado Pagos Bedingungen. Die Plattform dient dazu, Ihr eigenes Produkt zu testen und Ihre eigenen legitimen Konten zu betreiben – nicht dazu, Konten in Masse zu eröffnen oder Aktionen in Anspruch zu nehmen. Abgerechnet wird nutzungsbasiert aus einem vorausbezahlten USD-Wallet (Karte oder USDT/USDC, mit PDF-Rechnung für jede Aufladung), und auf Anfrage ist eine Sandbox mit simulierten Codes für Integrationstests verfügbar. Mercado Pago ist eine Marke ihres Inhabers, und OTP Route steht in keiner Verbindung zu ihr.

Häufige Fragen

Kann ich einen Mercado-Pago-OTP ohne lokale SIM-Karte in Brasilien oder Mexiko empfangen?

Ja, wenn Sie Ihr eigenes Konto testen oder betreiben. Bestellen Sie eine mercado_pago-Nummer für das passende Land und lesen Sie den Code aus dem Dashboard, der API oder einem Webhook aus.

Wie lautet die Dienst-ID für Mercado Pago in der API?

Sie lautet mercado_pago. Kombinieren Sie sie mit der Länder-ID im Body von POST /api/v1/activations.

Akzeptiert Mercado Pago virtuelle Nummern?

Nicht immer. Es kann sie in manchen Abläufen ablehnen, weshalb der volle Betrag erstattet wird, wenn innerhalb von 20 Minuten kein Code ankommt.

Was kostet eine Telefonnummer für die Mercado-Pago-Verifizierung?

Ab $0.20 pro Code. Der genaue Preis hängt vom Land ab und wird vor der Bestellung von API und Dashboard angezeigt.

Kann ich dieselbe Einmalnummer nutzen, um mich nächsten Monat erneut anzumelden?

Nein. Eine Einmalnummer empfängt einen einzigen Code. Konten mit wiederholten Anmeldungen sind mit einer Dedicated Number aus den USA oder Kanada besser bedient.

Kann meine CI-Pipeline den Mercado-Pago-Ablauf ohne echte Kosten durchspielen?

Ja. Fordern Sie den Sandbox-Modus für ein Entwicklungskonto an; er liefert simulierte Nummern und Codes über dieselben Endpunkte.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.