Programmatische +351-Bestätigungscodes für Markteinführungen in Portugal

Welche Endpunkte durchläuft eine +351-Verifizierung?

Die Basis-URL lautet https://otproute.com/api/v1, und jede Anfrage trägt einen Bearer-Key mit dem Präfix or_live_. Die Länderkennung für Portugal ist pt.

1. GET /api/v1/countries und GET /api/v1/services liefern die IDs; legen Sie sie pro Testlauf im Cache ab.
2. GET /api/v1/prices?country=pt&service=<id> gibt den aktuellen Preis zurück und zeigt, ob die Route offen ist.
3. POST /api/v1/activations mit {"service": "telegram", "country": "pt"} reserviert die Nummer und liefert eine Aktivierungs-ID.
4. GET /api/v1/activations/{id} meldet Status und Code, falls Sie lieber pollen.
5. POST /api/v1/activations/{id}/cancel gibt eine Nummer frei, die Ihr Test nicht mehr braucht.
6. Mit GET /api/v1/balance kann eine Pipeline frühzeitig abbrechen, wenn das Guthaben knapp ist.

Die Kontolimits betragen 10 API-Keys, 5 Webhook-Endpunkte und 300 Anfragen pro Minute. Die vollständigen Schemata finden Sie in der API-Referenz.

Wie liefern signierte Webhooks portugiesische Codes an unseren Dienst?

Registrieren Sie in der Developer-Konsole einen HTTPS-Endpunkt und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled. Jeder POST enthält X-OTPRoute-Signature: t=<unix>,v1=<hex>.

Zur Prüfung bauen Sie den String <t>.<raw body> nach, berechnen HMAC-SHA256 mit dem Secret des Endpunkts und vergleichen das Ergebnis mit v1 in konstanter Zeit. Lehnen Sie Anfragen mit zu altem Zeitstempel ab, damit ein abgefangener Request nicht erneut abgespielt werden kann. Speichern Sie die Aktivierungs-ID jedes Events und ignorieren Sie Wiederholungen; so bleibt der Handler auch bei erneuten Zustellversuchen sicher. Das Vorgehen wird Schritt für Schritt in Webhook-basierte OTP-Erfassung erklärt.

Welche Dienste sind auf portugiesischen Routen verfügbar?

Für Portugal zeigt der aktuelle Stand mehr als 2.000 Dienste. Häufig genutzt werden unter anderem WhatsApp, Telegram, Airbnb, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, LinkedIn, Microsoft & Outlook, Amazon, Netflix, Discord und Signal.

Das Angebot verändert sich im Tagesverlauf, weil unsere Carrier-Partner Kapazitäten verschieben. Deshalb sollte der Preis-Endpunkt und nicht eine statische Konfigurationsdatei entscheiden, ob ein Test läuft.

Warum testen Produktteams mit portugiesischen Nummern?

Portugal taucht bei einem EU-Rollout oft früh im Plan auf. In Lissabon und Porto sitzen viele Produkt- und Entwicklungsteams, und zahlreiche Unternehmen nutzen Portugal als europäische Basis. Hinzu kommt ein Lokalisierungsgrund: Europäisches Portugiesisch (pt-PT) unterscheidet sich vom brasilianischen in Rechtschreibung, Wortschatz und Anredeformen, sodass ein für Brasilien übersetzter Flow in Portugal seltsam klingen kann. Mit einer echten +351-Verifizierung sehen Reviewer den pt-PT-Text, die ankommende SMS und die umgebenden Bildschirme gemeinsam.

Auch unter der DSGVO ist es sinnvolle Datenminimierung, die Telefonnummern von Mitarbeitenden aus Test- und Sammelkonten herauszuhalten. Eine Einmalnummer pro Prüfung bedeutet weniger personenbezogene Kennungen in Ihren QA-Systemen. Der Leitfaden zu CI-Pipelines zeigt, wie sich das in jeden Build einbinden lässt.

Wie werden +351-Nummern formatiert und gespeichert?

Portugal hat kein Trunk-Präfix: Nummern haben neun Ziffern und werden im Inland wie in der internationalen Form nach +351 gleich gewählt. Mobilnummern beginnen mit 9, geografische Festnetznummern mit 2. Speichern Sie sie im E.164-Format, weisen Sie alles ab, was nach der Ländervorwahl nicht neun Ziffern hat, und entfernen Sie Leerzeichen, die Nutzer beim Eintippen in Dreiergruppen einfügen.

Eingehende Codes kommen in der Regel auf Portugiesisch oder Englisch an, je nach Absender und der für das Konto eingestellten Sprache. Ihr Code-Extraktor sollte nach den Ziffern suchen, nicht nach einer festen Formulierung.

Geht das auch ohne Code, und was tun, wenn keine SMS ankommt?

Öffnen Sie im Dashboard das OTP Gateway, wählen Sie Portugal und einen Dienst, prüfen Sie den aktuellen Preis und bestellen Sie. Fügen Sie die Nummer in Ihre App ein und warten Sie auf der Aktivierungsseite auf den Code.

Das Zeitfenster beträgt 20 Minuten, und Sie zahlen nur, wenn der Code ankommt; andernfalls fließt der volle Betrag automatisch zurück ins Guthaben. Wenn ein Code ausbleibt:

• Lassen Sie das Fenster ablaufen, statt nach wenigen Sekunden abzubrechen.
• Prüfen Sie, ob der Dienst in diesem Ablauf virtuelle Nummern akzeptiert.
• Versuchen Sie es später erneut oder testen Sie denselben Bildschirm mit einer anderen Dienstroute.
• Warten Sie zwischen den Versuchen, statt in einer engen Schleife neu zu bestellen.

Gibt es eine dedizierte portugiesische Leitung, und wie funktioniert die Abrechnung?

OTP Route bietet in Portugal keine Dedicated Numbers im Self-Service an. Dedicated Virtual Numbers gibt es nur für die USA und Kanada, ab $1.95/month; für eine langfristige +351-Leitung schreiben Sie an [email protected], wobei die Verfügbarkeit von den lokalen Vorschriften abhängt und nicht zugesichert ist. Siehe Unterschiede zwischen temporären und dedizierten Nummern.

Bezahlt wird nach Verbrauch aus einem vorausbezahlten USD-Guthaben, ohne Monatsgebühren oder Tarife; aufgeladen wird per Karte oder mit USDT/USDC, und zu jeder Aufladung gibt es eine PDF-Rechnung. Entwicklungskonten lassen sich auf Anfrage in den Sandbox-Modus schalten, um mit simulierten Nummern und Codes zu testen. Beachten Sie die Bedingungen des jeweiligen Dienstes; die Acceptable Use Policy von OTP Route gilt.

Häufige Fragen

Wie lautet die Länderkennung für Portugal in der OTP-Route-API?

Sie lautet pt und wird sowohl in der Preisabfrage als auch im Body der Aktivierungsanfrage verwendet.

Haben portugiesische Telefonnummern ein Trunk-Präfix wie eine führende 0?

Nein. Portugiesische Nummern haben neun Ziffern ohne Trunk-Präfix; die E.164-Form ist also +351 gefolgt von diesen neun Ziffern.

Kann ich einen pt-PT-Onboarding-Flow ohne portugiesische SIM-Karte testen?

Ja. Eine +351-Testnummer aus dem OTP Gateway empfängt den Code, den Sie im Dashboard oder über die API auslesen.

Was kostet eine Verifizierungsnummer für Portugal?

Ab $0.20 pro Code; der genaue Preis hängt vom Dienst ab und wird vor der Bestellung angezeigt.

Zahle ich für eine +351-Aktivierung, bei der nichts ankommt?

Nein. Abgelaufene oder stornierte Aktivierungen werden vollständig auf Ihr Guthaben zurückerstattet.

Kann ich eine portugiesische Nummer für wiederkehrende Logins mieten?

Nicht im Self-Service. Langfristige Leitungen sind ein Produkt für die USA und Kanada; wenn Sie eine +351-Leitung brauchen, schreiben Sie an den Support.

Sollte ich für portugiesische Codes pollen oder Webhooks nutzen?

Webhooks skalieren besser bei parallelen Jobs, während sich Polling von GET /api/v1/activations/{id} für Runner eignet, die keinen eingehenden Datenverkehr annehmen können.

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.