Paraguay-Bestätigungscodes (+595), API zuerst

Wie fordere ich eine +595-Nummer im Code an?

Beginnen Sie in der Developer-Konsole und erstellen Sie einen Bearer-Schlüssel; Schlüssel beginnen mit or_live_, und Sie können bis zu 10 halten, was getrennte Schlüssel für Staging und CI einfach macht. Alle Aufrufe gehen an https://otproute.com/api/v1.

1. Cachen Sie den Katalog aus GET /api/v1/services und GET /api/v1/countries. Paraguay erscheint als py.
2. Lesen Sie vor jeder Bestellung GET /api/v1/prices?country=py&service=<id>. Preis und Verfügbarkeit sind Live-Werte, keine Konstanten.
3. Bestellen Sie mit POST /api/v1/activations und {"service": "whatsapp", "country": "py"}. Behalten Sie die Aktivierungs-ID aus der Antwort.
4. Geben Sie die Nummer in dem Ablauf ein, den Sie testen.
5. Warten Sie auf den Webhook oder prüfen Sie GET /api/v1/activations/{id}; rufen Sie POST /api/v1/activations/{id}/cancel auf, wenn der Test früher endet.

GET /api/v1/balance ist als Vorabprüfung in einer Pipeline nützlich, damit ein Job bei leerem Guthaben laut fehlschlägt, statt in ein Timeout zu laufen. Die Integrationsanleitung führt dieselben Aufrufe mit mehr Kontext durch.

Was sollte der Webhook-Handler mit einem paraguayischen Code tun?

Ihr Endpunkt erhält activation.sms_received, wenn die Nachricht eintrifft, activation.expired, wenn das Fenster leer schließt, und activation.cancelled nach einer Stornierung. Jedes Ereignis ist an die Aktivierungs-ID gebunden.

• Zuerst prüfen. Zerlegen Sie X-OTPRoute-Signature in t und v1, berechnen Sie HMAC-SHA256 über den Zeitstempel, einen Punkt und den rohen Request-Body mit dem Endpunkt-Secret und vergleichen Sie in konstanter Zeit.
• Veraltete Anfragen abweisen. Ein Zeitstempel weit abseits Ihrer Uhr bedeutet einen Replay oder einen stark abweichenden Server.
• Idempotent bleiben. Speichern Sie die Aktivierungs-ID und ignorieren Sie Wiederholungen, damit eine erneute Zustellung einen Code nie doppelt verarbeitet.

Pro Konto sind bis zu 5 Webhook-Endpunkte erlaubt. Bevorzugen Sie Polling, halten Sie das Intervall moderat; das Limit liegt bei 300 Anfragen pro Minute für das gesamte Konto. Der Leitfaden zu HMAC-Webhooks enthält eine ausführlichere Checkliste.

Welche Dienste sind auf paraguayischen Routen verfügbar?

Paraguay bietet derzeit mehr als 1.600 Dienste. Zu den meistgefragten gehören WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix und ChatGPT (OpenAI). WhatsApp ist für viele Menschen in der Region der alltägliche Messenger und daher oft der erste Dienst, den Teams beim Testen von Chat-basiertem Support verifizieren.

Wie werden +595-Mobilnummern geschrieben und normalisiert?

Paraguay nutzt für Inlandsgespräche das nationale Präfix 0, eine lokal gesehene Mobilnummer beginnt also mit 09. In E.164 entfällt diese 0: Die kanonische Form ist +595 gefolgt von neun Ziffern, wobei Mobilnummern mit 9 beginnen. Normalisieren Sie bei der Eingabe, speichern Sie nur die E.164-Form und formatieren Sie für die Anzeige erst am Rand. Validierungsregeln, die eine feste Länge aus einem anderen Land erwarten, sind ein häufiger Grund, warum paraguayische Nutzer an der Registrierung scheitern; nehmen Sie daher eine +595-Nummer in Ihre Validierungstestfälle auf.

Spanisch und Guaraní sind beide Amtssprachen. Bestätigungsnachrichten internationaler Dienste kommen je nach Vorlage und Kontoeinstellung auf Spanisch oder Englisch an. Werten Sie den Code mit einem reinen Ziffernmuster aus und halten Sie Nachrichtentexte in UTF-8, damit Akzentzeichen und ñ im Logging erhalten bleiben.

Warum verifizieren Teams Konten in Paraguay?

Paraguay gehört zum Mercosur und liegt zwischen Argentinien, Brasilien und Bolivien, weshalb Unternehmen, die schon in der Region tätig sind, es oft in einen Südamerika-Rollout aufnehmen. Typische Gründe für Tests dort sind Lokalisierungs-QA auf Spanisch für ein paraguayisches Publikum, die Bestätigung, dass ein regionaler Onboarding-Ablauf +595-Nummern akzeptiert, Betriebsteams, die Geschäftsprofile für lokale Kunden verifizieren, und der Support für Paraguayer im Ausland, die sich mit ihren heimischen Nummern registrieren. Die Seite zur Verifizierung in Mobile-Apps beschreibt, wie sich diese Prüfungen in Release-Tests einfügen.

Gibt es einen Weg ohne Code zu einer Paraguay-Verifizierungsnummer?

Ja. Öffnen Sie im Dashboard das OTP Gateway, wählen Sie Paraguay und einen Dienst, prüfen Sie den Preis und bestätigen Sie. Kopieren Sie die Nummer in die App und lassen Sie die Aktivierung geöffnet, bis der Code daneben erscheint. Bestellungen im Browser und per API greifen auf dasselbe Guthaben und denselben Verlauf zu.

Was hilft, wenn ein +595-Code nicht erscheint?

Geben Sie der Aktivierung das volle 20-Minuten-Fenster, bevor Sie Schlüsse ziehen. Schließt es leer, kommt die Belastung automatisch zurück. Gehen Sie dann die üblichen Ursachen durch: Der Dienst lehnt möglicherweise virtuelle Nummern ab, die Route ist zu dieser Stunde ausgelastet, oder eine andere Dienstroute klappt später. Setzen Sie keine wiederholten Bestellungen in enger Schleife ab; bauen Sie zwischen den Versuchen ein Backoff ein und protokollieren Sie die Aktivierungs-IDs, um Muster je Dienst zu erkennen.

Kann ich eine paraguayische Nummer langfristig behalten, und wie läuft die Abrechnung?

Langfristige Leitungen werden für Paraguay nicht selbst buchbar verkauft. Dedicated Virtual Numbers gibt es nur in den Vereinigten Staaten und Kanada, ab $1.95/Monat, daher wird ein Konto, das sich weiter einloggen muss, oft auf einer dieser Nummern geparkt. Um nach einer langfristigen paraguayischen Leitung zu fragen, schreiben Sie an [email protected]; die Antwort hängt von den lokalen Vorschriften ab.

Die Abrechnung läuft über ein vorausbezahltes USD-Guthaben: Laden Sie per Karte oder USDT/USDC auf, erhalten Sie eine PDF-Rechnung per E-Mail und zahlen Sie nur für Codes, die ankommen. Entwicklungskonten können auf Anfrage in den Sandbox-Modus für simulierte Nummern und Codes geschaltet werden. OTP Route dient dem Testen und dem Betrieb Ihrer eigenen legitimen Produkte; beachten Sie die Bedingungen jedes Dienstes und die Acceptable Use Policy.

Häufige Fragen

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

Sie lautet py. Verwenden Sie sie in der Preisabfrage und im Body von POST /api/v1/activations.

Speichere ich paraguayische Nummern mit dem Präfix 09?

Nein. Lassen Sie die inländische 0 weg und speichern Sie +595 gefolgt von der neunstelligen nationalen Nummer.

Was kostet eine +595-Nummer zum Testen?

Eine paraguayische Aktivierung kostet je nach Dienst ab $0.20 pro Code, und das Guthaben wird nur für einen Code belastet, der tatsächlich eintrifft.

Kann ich einen spanischsprachigen Registrierungsablauf für Paraguay ohne lokale SIM testen?

Ja. Bestellen Sie im OTP Gateway eine Paraguay-Verifizierungsnummer und lesen Sie den Code im Dashboard oder über die API aus.

Kommen Codes auf Guaraní an?

Selten, wenn überhaupt. Internationale Dienste senden meist spanischen oder englischen Text, werten Sie daher nur die Ziffern aus.

Was passiert mit meinem Geld, wenn die Aktivierung abläuft?

Kommt innerhalb des 20-Minuten-Fensters keine SMS an, geht der volle Betrag automatisch zurück ins Guthaben.

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.