Samoa-OTP-API: +685-Registrierungen im Pazifik testen

Samoa auf einen Blick für Produkt- und QA-Teams

Samoa ist ein unabhängiger Inselstaat im Pazifik mit Samoanisch und Englisch als Amtssprachen. Eine große samoanische Gemeinschaft lebt in Neuseeland, Australien und den USA. Deshalb müssen Überweisungs-, Messaging- und Reise-Apps oft auch für Nutzer funktionieren, die zwischen diesen Ländern und der Heimat pendeln.

Zwei Besonderheiten sollten Sie kennen. Erstens ist Samoa (+685) etwas anderes als Amerikanisch-Samoa, das zum nordamerikanischen Nummernplan gehört und unter +1 684 erreichbar ist; wer beides in der Länderauswahl verwechselt, schickt Codes an den falschen Ort. Zweitens wechselte Samoa 2011 auf die westliche Seite der Datumsgrenze und liegt seitdem weit vor UTC, was es zu einem praktischen Testfall für Datumsgrenzen in Ablauflogik macht.

Für ein Produktteam ist Samoa selten ein eigener Launch-Markt. Meist taucht es als Teil eines Pazifik-Rollouts auf, als Anforderung einer auf die Diaspora ausgerichteten App oder weil eine Partnerorganisation in Apia ein Geschäftskonto bestätigen muss. Die Aufgabe ist jedes Mal dieselbe: nachweisen, dass ein Nutzer mit +685 Ihren Registrierungsablauf abschließen kann.

Wie behandelt man eine +685-Nummer im Code?

Samoanische Nationalnummern sind im Vergleich zu den meisten Märkten kurz, sodass Validatoren, die auf neun- oder zehnstellige Nummern ausgelegt sind, eine echte Nummer ablehnen können. Speichern Sie Nummern als +685 plus die nationalen Ziffern ohne Trennzeichen und entfernen Sie eine Null, die Nutzer aus Gewohnheit voranstellen. Da Webhook-Zeitstempel Unix-Sekunden sind, vergleichen Sie sie in UTC statt in Ortszeit; so vermeiden Sie Überraschungen, wenn Ihr Server und ein Tester in Samoa an unterschiedlichen Kalendertagen sitzen.

Wenn Ihr Produkt es erlaubt, im selben Profil zwischen einer neuseeländischen und einer samoanischen Nummer zu wechseln, ergänzen Sie einen Test, der die Landesvorwahl ändert und prüft, dass der alte Verifizierungsstatus zurückgesetzt wird. So wird ein an eine Nummer gesendeter Code nie für die andere akzeptiert.

Welche Dienste sind auf Samoa-Routen verfügbar?

Der Samoa-Katalog listet derzeit mehr als 600 Dienste. Zu den häufig angefragten gehören WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon und Discord. Die Abdeckung ist hier dünner als in großen Märkten und ändert sich im Tagesverlauf; prüfen Sie daher vor jedem Lauf GET /api/v1/services und GET /api/v1/countries. Fehlt ein Dienst, kann eine Nachbarroute wie Fidschi oder Tonga für Ihren Test passen.

Der schlankere Katalog ist ein guter Grund, die Testumgebung tolerant zu bauen: Fehlt der bevorzugte Dienst zur Laufzeit, markieren Sie den Fall als übersprungen statt als fehlgeschlagen und protokollieren Sie ihn, damit jemand es später erneut versuchen kann.

Einen Samoa-Code über die API anfordern

Mit einem Bearer-Key (or_live_…) gegen https://otproute.com/api/v1 fragen Sie den Preis über GET /api/v1/prices?country=ws&service=<id> ab und senden dann {"service": "<id>", "country": "ws"} an POST /api/v1/activations. Verfolgen Sie die Aktivierungs-ID, indem Sie GET /api/v1/activations/{id} abfragen oder auf activation.sms_received lauschen. Prüfen Sie bei jedem Webhook die HMAC-Signatur in X-OTPRoute-Signature, weisen Sie veraltete Zeitstempel zurück und machen Sie den Handler so, dass er für dieselbe Aktivierung gefahrlos zweimal laufen kann. Der Integrationsleitfaden zeigt den gesamten Ablauf.

Die Limits sind für einen Markt dieser Größe großzügig: Jedes Konto hat bis zu 10 Keys, 5 Webhook-Endpunkte und 300 Anfragen pro Minute. Beim Polling genügen wenige Sekunden Abstand zwischen den Abfragen.

Manuell im Dashboard vorgehen

1. Melden Sie sich an und öffnen Sie das OTP Gateway.
2. Wählen Sie den Dienst und dann Samoa.
3. Prüfen Sie den aktuellen Preis und bestätigen Sie.
4. Tragen Sie die +685-Nummer in die zu testende App ein und fordern Sie den Code an.
5. Lesen Sie den Code auf dem Bildschirm ab oder brechen Sie ab, wenn Sie ihn nicht mehr brauchen.

Wenn ein +685-Code langsam kommt oder ausbleibt

Lassen Sie die Aktivierung die vollen 20 Minuten offen, bevor Sie aufgeben. Manche Apps lehnen virtuelle Nummern grundsätzlich ab, und genau dafür gibt es die Erstattung unbeantworteter Bestellungen. Bleibt eine Route stumm, versuchen Sie es später oder wählen Sie eine andere Dienstroute; neue Bestellungen in enger Schleife helfen selten und verbrauchen Ihr Anfragelimit.

Protokollieren Sie die Aktivierungs-ID bei jedem Versuch, damit Sie sehen, ob das Schweigen von einer bestimmten App oder von der ganzen Route kam.

Langzeitnummern und Bezahlung

OTP Route verkauft keine selbst buchbare samoanische Langzeitnummer. Dedicated Numbers gibt es ab $1.95/month und nur in den USA und Kanada; für eine Leitung in Samoa schreiben Sie an [email protected], ohne Zusage, dass sich etwas einrichten lässt. Das vorausbezahlte USD-Wallet akzeptiert Karten und USDT/USDC, schickt pro Aufladung eine PDF-Rechnung und hat keine monatliche Gebühr. Lassen Sie auf einem Entwicklungskonto den Sandbox-Modus freischalten, um den ws-Ablauf ohne Guthabeneinsatz zu üben.

Häufige Fragen

Ist Samoa bei Telefonnummern dasselbe wie Amerikanisch-Samoa?

Nein. Samoa nutzt +685, Amerikanisch-Samoa dagegen +1 684. Wählen Sie in Ihrer Länderauswahl und in der API das richtige Land.

Wie lautet die API-Länder-ID für Samoa?

Verwenden Sie ws in der Preisabfrage und in der Aktivierungsanfrage.

Was kostet ein Verifizierungscode für Samoa?

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

Kann ich die Registrierung eines samoanischen Nutzers aus Neuseeland oder Australien testen?

Ja. Die +685-Nummer empfängt die SMS, und OTP Route zeigt sie Ihnen, egal wo Ihr Team arbeitet.

Zahle ich, wenn keine Nachricht ankommt?

Nein. Abgelaufene oder stornierte Aktivierungen werden automatisch dem Wallet gutgeschrieben.

In welchen Sprachen kommen Codes für Samoa?

Meist auf Englisch, das neben Samoanisch Amtssprache ist. Werten Sie die Ziffern aus, nicht den umgebenden Text.

Kann ich diese Nummern nutzen, um viele Konten zu eröffnen?

Nein. Halten Sie sich an die Bedingungen jedes Dienstes; die Acceptable Use Policy beschränkt OTP Route auf Tests und den Betrieb Ihrer eigenen legitimen Produkte und Konten.

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.