Polen-Bestätigungscodes (+48): Checkliste, API-Schritte und Lösungen

Vorabcheck: Was brauche ich, bevor ich polnische Registrierungen teste?

Gehen Sie diese Liste einmal durch, dann verläuft die erste polnische Bestellung meist ereignislos:

1. Zugangsdaten. Erzeugen Sie in der Developer-Konsole einen Bearer-Schlüssel (er beginnt mit or_live_). Getrennte Schlüssel für Staging, CI und Produktion machen die Rotation schmerzlos.
2. Kennungen. Polen ist pl. Beziehen Sie Dienst-IDs aus GET /api/v1/services, statt Anzeigenamen fest zu verdrahten.
3. Guthaben. Laden Sie das Guthaben auf; jeder Preis ist vor der Bestellung sichtbar.
4. Zustellziel. Registrieren Sie einen HTTPS-Webhook und halten Sie sein Secret aus der Quellcodeverwaltung heraus. Polling funktioniert ebenfalls, wenn eingehender Verkehr blockiert ist.
5. Anfragebudget. Die API erlaubt 300 Anfragen pro Minute und Konto, drosseln Sie parallele Suiten entsprechend.
6. Umfang. Verifizieren Sie nur Konten, die zu Ihrem eigenen Produkt, Ihrem Unternehmen oder Ihrem Kunden gehören, und beachten Sie neben unserer Acceptable Use Policy die Bedingungen jedes Dienstes.

Speziell für Pipelines lesen Sie SMS-OTP-Tests in CI-Pipelines.

Welche Dienste senden derzeit Codes an +48-Nummern?

Für das OTP-Routing ist Polen einer der breiteren Einträge im Katalog und deckt mehr als 2.300 Dienste ab. Der aktuelle Stand beliebter Dienste umfasst Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber und Netflix.

Betrachten Sie diese Liste als Ausgangspunkt, nicht als Zusage. Die Verfügbarkeit auf jeder Route ändert sich im Tagesverlauf, fragen Sie daher vor jeder Bestellung den Preis-Endpunkt für die jeweilige Kombination ab.

Was sind die genauen Schritte der Polen-OTP-API?

Mit der SMS-Verifizierungs-API unter https://otproute.com/api/v1 geht ein automatisierter Test so vor:

1. GET /api/v1/prices?country=pl&service=<id> bestätigt einen Live-Preis für diesen Dienst in Polen.
2. POST /api/v1/activations mit {"service": "<id>", "country": "pl"} liefert die +48-Nummer und eine Aktivierungs-ID.
3. Ihr Test tippt die Nummer in das Registrierungsformular und fordert die SMS an.
4. Der Handler erhält activation.sms_received; sieht er activation.expired oder activation.cancelled, markiert er den Lauf als nicht zugestellt.
5. Ohne Webhook lesen Sie GET /api/v1/activations/{id} alle paar Sekunden aus, bis der Code erscheint oder das Fenster endet.
6. Rufen Sie POST /api/v1/activations/{id}/cancel auf, wenn ein Test vorzeitig abgebaut wird.

Validieren Sie den Header X-OTPRoute-Signature, bevor Sie einer Nutzlast vertrauen: Er enthält t=<unix>,v1=<hex>, wobei v1 der HMAC-SHA256 von <t>.<raw body> ist, signiert mit dem Endpunkt-Secret. Weisen Sie alles mit altem Zeitstempel ab und machen Sie den Handler anhand der Aktivierungs-ID idempotent. Der Leitfaden zur Webhook-Sicherheit zeigt die Prüfung im Detail.

Kann mein Betriebsteam eine polnische Nummer ohne die API bestellen?

Ja. Öffnen Sie im OTP-Route-Dashboard das OTP Gateway, wählen Sie Polen, suchen Sie den Dienst und bestätigen Sie den angezeigten Preis. Kopieren Sie nach der Bestellung die Polen-Verifizierungsnummer in den Verifizierungsbildschirm der App und beobachten Sie die Aktivierungskarte; der SMS-Text erscheint dort, sobald er empfangen wird. Es muss nichts installiert werden, und dasselbe Guthaben finanziert Browser und API.

Was ist bei polnischen Nummern und Nachrichten anders zu handhaben?

Polen verwendet einen geschlossenen Nummerierungsplan ohne nationales Präfix: Jede Nummer, ob Mobil- oder Festnetz, hat nach +48 neun Ziffern. Das macht die Validierung angenehm streng. Weisen Sie Eingaben zurück, die sich nicht auf neun nationale Ziffern reduzieren lassen, entfernen Sie Leerzeichen und Bindestriche, die Nutzer in Dreiergruppen einfügen, und speichern Sie +48 plus die neun Ziffern als einen einzigen E.164-String. Eine überzählige führende Null ist ein Tippfehler und kein Präfix, das erhalten bleiben muss.

Bestätigungsnachrichten kommen oft auf Polnisch an, wenn die Kontosprache Polnisch ist. Zeichen wie ą, ę, ł und ż liegen außerhalb des GSM-7-Bit-Alphabets; wenn Sie eigene polnische OTP-Texte versenden, rechnen Sie daher mit kürzeren Segmenten und testen Sie die Vorlage so, wie sie auf einem Handy tatsächlich dargestellt wird. Beim Parsen eingehender Codes konzentrieren Sie sich auf die Ziffern und ignorieren die Wörter drumherum.

Häufige Gründe, hier zu testen: ein Produkt, das in den polnischen Markt eintritt, Lokalisierungs-QA für polnischsprachige Abläufe, regionale Teams, die Geschäftskonten in Mitteleuropa betreuen, und Apps, deren Kunden Polnischsprachige in anderen EU-Ländern einschließen.

Fehlersuche: Warum fehlt der +48-Code?

• Das Fenster ist noch offen. Geben Sie ihm die vollen 20 Minuten, bevor Sie etwas folgern; berechnet wird nur, wenn ein Code ankommt.
• Der Dienst lehnt möglicherweise virtuelle Nummern ab. Manche Plattformen tun das, und dann legt die automatische Erstattung den vollen Betrag zurück ins Guthaben.
• Die Route ist ausgelastet. Versuchen Sie es später erneut oder testen Sie eine andere Dienstroute.
• Der Test läuft in einer Schleife. Alle paar Sekunden neu zu bestellen verbrennt Ihr Anfragebudget, bauen Sie ein Backoff ein.

Weitere Muster sind unter Fehlgeschlagene OTP-Zustellungen reduzieren gesammelt.

Gibt es in Polen dedizierte Nummern, und wie funktionieren Zahlungen?

Nicht als selbst buchbares Produkt. Dedicated Virtual Numbers, ab $1.95/Monat, werden nur in den Vereinigten Staaten und Kanada angeboten. Für eine langfristige polnische Leitung schreiben Sie an [email protected]; die lokalen Vorschriften entscheiden, ob das möglich ist, eine Zusage gibt es daher nicht.

Zahlungen fließen in ein einziges vorausbezahltes USD-Guthaben: kein Tarif, keine Monatsgebühr, Aufladung per Karte oder USDT/USDC und für jede Aufladung eine per E-Mail versandte PDF-Rechnung. Entwickler können für ein Entwicklungskonto den Sandbox-Modus beantragen, um beim Bau der Integration simulierte Nummern und Codes zu erhalten. Aktuelle Preise finden Sie unter Preise.

Häufige Fragen

Wie teste ich einen polnischen Registrierungsablauf, wenn niemand im Team eine +48-SIM hat?

Bestellen Sie im OTP Gateway eine +48-Nummer zum Testen und verwenden Sie sie im Ablauf. Der Code erscheint im Dashboard und kann an Ihren Webhook gesendet werden.

Wie lautet die Länderkennung für Polen in OTP-Route-API-Aufrufen?

Sie lautet pl und wird sowohl in POST /api/v1/activations als auch in der Preisabfrage verwendet.

Wie viele Ziffern hat eine polnische Telefonnummer?

Neun nationale Ziffern nach +48, ohne Präfix-Null. Diese feste Länge macht die serverseitige Validierung unkompliziert.

Was kostet der Empfang eines Polen-SMS-OTP?

Die Preise beginnen ab $0.20 pro Code und variieren je nach Dienst. Das Dashboard und der Preis-Endpunkt zeigen den genauen Betrag vor der Bestellung.

Verliere ich Geld, wenn eine polnische Aktivierung leer abläuft?

Nein. Eine Aktivierung, die ohne Code endet, oder eine, die Sie stornieren, wird vollständig ins Guthaben erstattet.

Kann ich den gesamten Polen-Ablauf vor dem Livegang simulieren?

Ja. Beantragen Sie den Sandbox-Modus für ein Entwicklungskonto, um simulierte Nummern und Codes zu erhalten, ohne Guthaben auszugeben.

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.