Verifizierungsnummern für Guatemala (+502) für Tests und Betrieb

Was macht Guatemala zu einem eigenen Testlauf wert?

Guatemala ist das bevölkerungsreichste Land Zentralamerikas und für viele Teams der erste Markt eines spanischsprachigen regionalen Rollouts. Spanisch ist Amtssprache, während ein großer Teil der Bevölkerung auch eine der vielen Maya-Sprachen spricht, was wichtig wird, wenn Ihre Onboarding-Texte oder Support-Inhalte über Spanisch hinausgehen.

Drei Situationen kommen immer wieder vor:

• Regionale Markteinführungen, bei denen die Telefoneingabe, der spanische SMS-Wortlaut und der Verifizierungsschritt auf einer echten +502-Route geprüft werden müssen (Verifizierung mobiler Apps).
• Diaspora-Produkte wie Überweisungs- oder Telefonie-Apps für in den USA lebende Guatemalteken, bei denen das Konto an eine Nummer im Heimatland gebunden ist.
• Betriebsteams, die Geschäftsprofile für guatemaltekische Kunden führen und das private Telefon niemandes verknüpfen möchten (Operations-Teams).

Wie sind guatemaltekische Telefonnummern aufgebaut?

Guatemala verwendet achtstellige nationale Nummern und hat kein Trunk-Prefix, es gibt also keine führende Null zu entfernen. Die E.164-Form ist schlicht +502 gefolgt von diesen acht Ziffern, geschrieben als +502 xxxx xxxx.

Diese kurze Länge bringt Formularvalidatoren ins Straucheln, die auf zehnstellige nordamerikanische Nummern ausgelegt sind. Ergänzen Sie Testfälle für eine achtstellige Eingabe, für Nutzer, die 502 ohne Pluszeichen tippen, und für Leerzeichen oder Bindestriche in der Mitte. Speichern Sie den normalisierten E.164-String und raten Sie nicht allein anhand der Länge, ob eine Nummer mobil oder Festnetz ist, denn beide haben dieselben acht Ziffern.

Kann ich Guatemala-SMS-OTP-Codes über die API empfangen?

Ja. Die Guatemala-OTP-API nutzt die Länderkennung gt gegen die Basis-URL https://otproute.com/api/v1, authentifiziert mit einem Bearer-Schlüssel mit dem Präfix or_live_.

Beginnen Sie mit GET /api/v1/services, um die Dienst-ID zu finden, und prüfen Sie dann das aktuelle Angebot mit GET /api/v1/prices?country=gt&service=<id>. Erzeugen Sie die Nummer mit POST /api/v1/activations und dem Body {"service": "<id>", "country": "gt"}. Sobald Ihre App die SMS sendet, pollen Sie entweder GET /api/v1/activations/{id} oder lassen einen Webhook-Endpunkt activation.sms_received empfangen. Prüfen Sie den Header X-OTPRoute-Signature, einen HMAC-SHA256 über Zeitstempel und rohen Body, und lehnen Sie veraltete Zeitstempel ab, wie im Beitrag zum Absichern von OTP-Webhooks beschrieben. Die Entwicklerübersicht nennt die Limits: 10 Schlüssel, 5 Webhook-Endpunkte, 300 Anfragen pro Minute.

Welche Dienste sind derzeit auf der +502-Route verfügbar?

Für Guatemala werden mehr als 1.600 Dienste geführt. Der aktuelle Stand beliebter Dienste umfasst WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix und Microsoft & Outlook. Der Bestand wechselt im Tagesverlauf, weshalb die API die Verfügbarkeit live zurückgibt statt eines festen Katalogs.

Gibt es einen Weg ohne Code für Support- und Betriebsmitarbeitende?

Jede Person im Team kann im Dashboard bestellen, nachdem Sie sich angemeldet haben, mit E-Mail und einem 6-stelligen Code oder per Google-Anmeldung. Wählen Sie Guatemala, wählen Sie den Dienst, bestätigen Sie den angezeigten Preis und kopieren Sie die +502-Nummer in die App. Der Code erscheint auf demselben Bildschirm, sobald er eintrifft. Die Zwei-Faktor-Authentifizierung (TOTP) für das OTP-Route-Konto selbst zu aktivieren ist bei gemeinsamem Teamzugriff sinnvoll.

Warum kam mein +502-Code nicht an, und was kann ich versuchen?

Die Nummer bleibt 20 Minuten aktiv, und die Belastung erfolgt nur, wenn ein Code zugestellt wird. Läuft das Fenster ab oder stornieren Sie, geht der volle Betrag automatisch zurück ins Guthaben.

1. Warten Sie das Fenster ab; die Zustellzeit hängt von Dienst und Route ab.
2. Versuchen Sie es später erneut oder über eine andere Dienstroute, falls eine angeboten wird.
3. Prüfen Sie, ob der Dienst virtuelle Nummern akzeptiert, denn manche lehnen sie ab.
4. Setzen Sie keine neuen Bestellungen in enger Schleife ab; lassen Sie zwischen den Versuchen Abstand.

Wie steht es um guatemaltekische Langzeitnummern, Abrechnung und Sandbox?

Eine selbst buchbare guatemaltekische Langzeitnummer gibt es bei OTP Route nicht. Dedizierte Leitungen gibt es nur für die USA und Kanada, ab $1.95/Monat. Brauchen Sie eine dauerhafte +502-Leitung, schreiben Sie an [email protected]; ob sich etwas einrichten lässt, hängt von den lokalen Vorschriften ab und ist nicht gesichert.

Bezahlt wird über ein vorausbezahltes USD-Guthaben ohne Tarif und Monatsgebühr, aufgeladen per Karte oder USDT/USDC, mit einer per E-Mail versandten PDF-Rechnung zu jeder Aufladung. Für Integrationsarbeit kann ein Entwicklungskonto auf Anfrage auf Sandbox umgestellt werden, sodass simulierte Nummern und Codes kostenlos durch Ihren Code fließen.

Häufige Fragen

Kann ich unsere spanischsprachige Registrierung für Guatemala ohne lokale SIM-Karte prüfen?

Ja. Bestellen Sie im OTP Gateway eine gt-Nummer, geben Sie sie in Ihre App ein und lesen Sie den spanischen Code im Dashboard oder an Ihrem Webhook.

Brauchen guatemaltekische Nummern eine führende Null?

Nein. Guatemala hat kein Trunk-Prefix, eine Nummer besteht also einfach aus +502 plus acht Ziffern.

Wie günstig kann ein +502-Code höchstens sein?

Die Preise beginnen bei $0.20 pro Code; den Betrag für einen bestimmten Dienst liefert GET /api/v1/prices, und er wird vor der Bestätigung angezeigt.

Werde ich belastet, wenn die Verifizierungs-SMS nie kommt?

Nein. Ohne zugestellten Code innerhalb des 20-Minuten-Fensters oder nach einer Stornierung geht der volle Betrag zurück ins Guthaben.

Kann OTP Route dieselbe +502-Nummer langfristig für mein Team behalten?

Nicht selbst buchbar. Nummern des OTP Gateway bedienen einen einzigen Code, und Langzeitleitungen gibt es nur in den USA und Kanada, fragen Sie wegen Guatemala also unter [email protected] nach.

Welche Regeln gelten für die Nutzung dieser Nummern?

Die Bedingungen des jeweiligen Dienstes sowie die Acceptable Use Policy von OTP Route. Nutzen Sie die Nummern nur zum Testen oder für den Betrieb Ihrer eigenen, legitimen Produkte und Geschäftskonten.

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.