Argentinische Verifizierungscodes (+54) in Ihre Integration holen

Welche vier API-Aufrufe stehen hinter einer +54-Aktivierung?

Alles läuft unter https://otproute.com/api/v1 und wird mit einem Bearer-Schlüssel authentifiziert, der mit or_live_ beginnt. Schlüssel werden in der Developer-Konsole ausgestellt; ein Konto kann bis zu 10 davon halten und 5 Webhook-Endpoints registrieren, bei einer Obergrenze von 300 Anfragen pro Minute.

1. Preis abfragen. Rufen Sie GET /api/v1/prices?country=ar&service=<id> auf, damit Ihr Code den Live-Preis kennt, bevor er Guthaben bindet. Die Länder-ID für Argentinien ist ar.
2. Bestellen. Senden Sie POST /api/v1/activations mit dem JSON-Body {"service": "whatsapp", "country": "ar"} und setzen Sie die Dienst-ID ein, die Ihr Test braucht. Die Antwort enthält eine Aktivierungs-ID und die +54-Nummer, die Sie in die getestete App eintippen.
3. Warten. Lesen Sie entweder GET /api/v1/activations/{id} in einem sinnvollen Intervall aus oder lassen Sie sich per activation.sms_received-Webhook melden, dass der Code da ist.
4. Bei Bedarf früh freigeben. POST /api/v1/activations/{id}/cancel beendet eine Aktivierung, die Sie nicht mehr brauchen, und schreibt das Geld dem Wallet gut.

Wenn Sie die IDs sehen möchten, bevor Sie sie fest eintragen, listen GET /api/v1/services und GET /api/v1/countries auf, was die Plattform aktuell anbietet. Die vollständige Referenz finden Sie in der Dokumentation.

Wie mache ich den Webhook-Empfänger für argentinische Codes vertrauenswürdig?

Jede Zustellung enthält einen Header X-OTPRoute-Signature der Form t=<unix>,v1=<hex>. Bauen Sie den String "<t>.<raw body>" nach, berechnen Sie darüber HMAC-SHA256 mit dem Secret des jeweiligen Endpoints und vergleichen Sie das Ergebnis mit v1 über eine konstantzeitliche Funktion. Verwerfen Sie jede Anfrage mit veraltetem Zeitstempel, denn eine alte, aber gültige Signatur sieht genau so aus wie ein Replay-Angriff.

Abonnieren Sie neben activation.sms_received auch activation.expired und activation.cancelled, damit ein Test-Runner nie auf eine Nummer wartet, die bereits geschlossen ist. Behandeln Sie jedes Ereignis anhand der Aktivierungs-ID und schreiben Sie Ihren Handler so, dass eine zweite Zustellung desselben Ereignisses nichts ändert. Der Beitrag zum Signieren und Verifizieren von OTP-Webhooks erklärt die Vergleichslogik ausführlicher.

Welche Apps lassen sich mit einer argentinischen Nummer verifizieren?

Der Live-Snapshot für Argentinien listet mehr als 2.000 Dienste. Zu denen, die argentinische Produkt- und QA-Teams häufig nutzen, gehören:

• Messaging: WhatsApp, Telegram, Signal, Discord
• Konten und Produktivität: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Social und Video: Instagram, TikTok
• Handel und Mobilität: Amazon, Uber, Airbnb, Netflix

Diese Liste ändert sich im Tagesverlauf, weshalb die API die Verfügbarkeit live meldet statt in einer statischen Tabelle. Fragen Sie GET /api/v1/services mit Blick auf das Land ar ab, bevor ein geplanter CI-Job startet, und lassen Sie ihn mit einer klaren Meldung früh scheitern, wenn Ihr Zieldienst vorübergehend fehlt.

Warum bringen argentinische Mobilnummern Telefon-Validatoren aus dem Takt?

Argentinien hat einen der ungewöhnlicheren Nummernpläne der Region. Im Inland schreibt man vor der Ortsvorwahl eine 0 und bei Mobilnummern eine 15 vor die Teilnehmerziffern, sodass ein Handy in Buenos Aires als 011 15 gefolgt von acht Ziffern erscheinen kann. In der internationalen E.164-Form verschwinden beide, und nach der Landesvorwahl wird eine 9 eingefügt: +54 9 11 und dann die achtstellige Teilnehmernummer.

Dieser Unterschied zählt für alle, die Telefonnummern speichern. Normalisieren Sie alles vor dem Speichern auf E.164, entfernen Sie bei der Eingabe die 0 und die 15 und ergänzen Sie für Mobilnummern die 9. Ein Validator, der nur die Länge prüft, akzeptiert bereitwillig einen Festnetz-artigen +54-11-Wert, der keine SMS empfangen kann. Verwenden Sie die Nummer genau so, wie die API sie zurückgibt, statt sie selbst umzuformatieren.

Codes an argentinische Nummern kommen meist auf Spanisch an, oft mit einer Wendung wie „Tu código es“ um die Ziffern. Lesen Sie den numerischen Code mit einem Muster aus, statt auf Formulierungen zu prüfen, denn Vorlagen ändern sich. Teams testen hier, wenn sie in Lateinamerika starten, rioplatensischen Spanisch-Text prüfen (die lokalen vos-Formen weichen vom Lehrbuchspanisch ab), regionale Abläufe betreiben oder Argentinier im Ausland bedienen, die sich weiterhin mit einer +54-SIM registrieren.

Kann jemand ohne Code eine +54-Nummer bestellen?

Ja. Support-, Growth- und Agentur-Mitarbeitende können alles im Browser erledigen:

1. Erstellen Sie auf der Registrierungsseite ein Konto mit E-Mail-Adresse und 6-stelligem Code oder per Google-Anmeldung.
2. Laden Sie Guthaben ins Wallet.
3. Öffnen Sie das OTP Gateway, wählen Sie Argentinien und dann den Dienst, den Sie testen.
4. Prüfen Sie den angezeigten Preis, bestätigen Sie und kopieren Sie die +54-Nummer in den Verifizierungsbildschirm der App.
5. Beobachten Sie die Aktivierung; der Code erscheint dort, sobald er eingegangen ist.

Dashboard und API nutzen dasselbe Wallet und dieselben Aktivierungen, sodass ein Entwickler eine von einer Kollegin bestellte Nummer über deren Aktivierungs-ID übernehmen kann.

Der argentinische Code kam nicht an. Wie geht es weiter?

Jede Aktivierung bleibt 20 Minuten offen. Kommt nichts an oder brechen Sie vorher ab, wird der volle Betrag automatisch dem Wallet gutgeschrieben – eine stumme Route kostet Sie also Zeit, kein Geld. Die Zustellgeschwindigkeit hängt vom Dienst und von der Route ab; geben Sie dem Fenster daher eine faire Chance, bevor Sie es als gescheitert werten.

Gehen Sie dann diese kurze Liste durch:

• Fordern Sie den Code einmal aus der App heraus erneut an und lassen Sie dann das Fenster laufen.
• Versuchen Sie es später am Tag oder bestellen Sie über eine andere Route für denselben Dienst.
• Prüfen Sie, ob der Dienst virtuelle Nummern überhaupt akzeptiert; manche lehnen sie ab, und genau dafür gibt es die automatische Erstattung.
• Vermeiden Sie enge Neubestell-Schleifen aus CI heraus. Ergänzen Sie ein Back-off und eine Obergrenze für Wiederholungen.

Unser Beitrag zu weniger fehlgeschlagenen OTP-Zustellungen behandelt weitere Muster für argentinische Routen. Halten Sie jeden Test innerhalb der Bedingungen des jeweiligen Dienstes ein; außerdem gilt die Acceptable Use Policy von OTP Route.

Können wir eine argentinische Nummer behalten, und wie bezahlen wir?

Für Argentinien gibt es derzeit keine selbst buchbare Langzeitnummer. Braucht Ihr Team eine dauerhafte +54-Nummer, schreiben Sie an [email protected] und beschreiben Sie den Anwendungsfall; ob sie sich einrichten lässt, hängt von den lokalen Vorschriften ab und ist nicht gesichert. Dedicated Virtual Numbers, die Sie behalten, solange sie sich verlängern, und die eingehende SMS an Ihren Webhook weiterleiten, sind ein Produkt für die USA und Kanada ab $1.95/Monat.

Abgerechnet wird über ein vorausbezahltes USD-Wallet ohne Monatsgebühr und ohne Tarifwahl. Laden Sie per Karte oder mit USDT/USDC auf; jede Aufladung erzeugt eine PDF-Rechnung per E-Mail. Details stehen auf der Seite Preise. Bevor Sie echtes Guthaben ausgeben, bitten Sie darum, Ihr Entwicklungskonto auf Sandbox umzustellen: Es liefert simulierte Nummern und Codes, sodass Sie den gesamten Argentinien-Ablauf Ende-zu-Ende proben können.

Häufige Fragen

Wie lautet die Länder-ID für Argentinien in der OTP-Route-API?

Sie lautet ar. Übergeben Sie sie im Feld country von POST /api/v1/activations und im Query-String von GET /api/v1/prices.

Muss ich die 9 ergänzen, wenn ich die +54-Nummer in eine App eintippe?

Verwenden Sie die Nummer genau so, wie OTP Route sie zurückgibt. Speichern Sie argentinische Mobilnummern in Ihrer eigenen Datenbank in der E.164-Form, die nach +54 die 9 enthält und die nationale 0 sowie die 15 weglässt.

Was kostet der Empfang eines SMS-OTP aus Argentinien?

Ab $0.20 pro Code, je nach Dienst unterschiedlich. Den genauen Betrag liefert GET /api/v1/prices, und er wird vor der Bestätigung einer Bestellung angezeigt.

Kann ich den Registrierungsablauf meiner App für Argentinien ohne lokale SIM testen?

Ja. Bestellen Sie eine Argentinien-Aktivierung für Ihre eigene App oder den Drittdienst in Ihrem Test, geben Sie die +54-Nummer ein und lesen Sie den Code im Dashboard oder von Ihrem Webhook ab.

Funktioniert dieselbe +54-Nummer nächsten Monat noch einmal für einen Login?

Nein. Eine Gateway-Nummer deckt einen einzelnen Code innerhalb von 20 Minuten ab. Für Konten, die dauerhaft Codes empfangen müssen, ist eine Dedicated Number in den USA oder Kanada die passende Wahl.

In welcher Sprache kommt der argentinische Verifizierungstext an?

Meist auf Spanisch, abhängig vom Absender und von den Spracheinstellungen des Kontos. Lesen Sie die Ziffern aus, statt sich auf umgebende Wörter zu verlassen.

Ist Polling statt Webhooks zulässig?

Ja. Fragen Sie GET /api/v1/activations/{id} in moderatem Abstand ab und bleiben Sie deutlich unter dem Limit von 300 Anfragen pro Minute und Konto.

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.