Paraguay (+595) verification codes, API first

How do I request a +595 number in code?

Start in the Developer console and create a Bearer key; keys begin with or_live_ and you can hold up to 10, which makes separate keys for staging and CI easy. All calls go to https://otproute.com/api/v1.

1. Cache the catalog from GET /api/v1/services and GET /api/v1/countries. Paraguay appears as py.
2. Before each order, read GET /api/v1/prices?country=py&service=<id>. Price and availability are live values, not constants.
3. Order with POST /api/v1/activations and {"service": "whatsapp", "country": "py"}. Keep the activation id from the response.
4. Submit the number in the flow you are testing.
5. Wait for the webhook or check GET /api/v1/activations/{id}; call POST /api/v1/activations/{id}/cancel if the test stops early.

GET /api/v1/balance is useful as a pre-flight step in a pipeline, so a job fails loudly on an empty wallet instead of timing out. The integration guide walks through the same calls with more context.

What should the webhook handler do with a Paraguayan code?

Your endpoint receives activation.sms_received when the message lands, activation.expired when the window closes empty, and activation.cancelled after a cancel. Each is tied to the activation id.

• Verify first. Split X-OTPRoute-Signature into t and v1, compute HMAC-SHA256 of the timestamp, a dot and the raw request body with the endpoint secret, and compare in constant time.
• Reject stale requests. A timestamp far from your clock means a replay or a badly skewed server.
• Be idempotent. Store the activation id and ignore repeats, so a retried delivery never double-processes a code.

Up to 5 webhook endpoints are allowed per account. If you prefer polling, keep the interval modest; the limit is 300 requests per minute across the account. The HMAC webhook guide has a fuller checklist.

Which services are open on Paraguayan routes?

Paraguay currently offers more than 1,600 services. Among the most requested are WhatsApp, Instagram, Telegram, Uber, Facebook, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, X (Twitter), Discord, LinkedIn, Netflix and ChatGPT (OpenAI). WhatsApp is the everyday messenger for many people in the region, so it is often the first service teams verify when testing chat-based support.

How are +595 mobile numbers written and normalized?

Paraguay uses a trunk prefix of 0 for domestic dialing, so a mobile number seen locally starts with 09. In E.164 that 0 goes away: the canonical form is +595 followed by nine digits, with mobiles beginning with 9. Normalize on input, store only the E.164 form, and format for display at the edge. Validation rules that expect a fixed length from a different country are a common reason Paraguayan users fail registration, so include a +595 number in your validation test cases.

Spanish and Guaraní are both official languages. Verification messages from international services tend to come in Spanish or English depending on the template and account settings. Parse the code with a digit-only pattern and keep message bodies in UTF-8 so accented characters and ñ survive logging.

Why do teams verify accounts in Paraguay?

Paraguay is part of Mercosur and sits between Argentina, Brazil and Bolivia, so companies that already operate in the region often add it to a South American rollout. Typical reasons to test there include Spanish-language localization QA for a Paraguayan audience, confirming that a regional onboarding flow accepts +595 numbers, operations teams verifying business profiles for local clients, and support for Paraguayans abroad who register with home numbers. The mobile app verification page describes how these checks fit into release testing.

Is there a no-code way to get a Paraguay verification number?

Yes. In the dashboard, open the OTP Gateway, choose Paraguay and a service, review the price, and confirm. Copy the number into the app, then leave the activation open until the code appears next to it. Browser orders and API orders draw on the same wallet and history.

What helps when a +595 code does not show up?

Give the activation the full 20-minute window before drawing conclusions. If it closes empty, the charge comes back automatically. Then work through the usual causes: the service may refuse virtual numbers, the route may be congested at that hour, or a different service route may succeed later. Do not fire repeated orders in a tight loop; add backoff between attempts and log the activation ids so you can spot patterns per service.

Can I keep a Paraguayan number long term, and how is billing handled?

Long-term lines are not sold self-serve for Paraguay. Dedicated Virtual Numbers exist only in the United States and Canada, from $1.95/month, so an account that must keep logging in is often parked on one of those instead. To ask about a Paraguayan long-term line, email [email protected]; the answer depends on local rules.

Billing uses one prepaid USD wallet: top up by card or USDT/USDC, receive a PDF invoice by email, and pay only for codes that arrive. Development accounts can be switched to sandbox on request for simulated numbers and codes. OTP Route is for testing and operating your own legitimate products; follow each service's terms and the Acceptable Use Policy.

Frequently asked questions

What is the country id for Paraguay in the OTP Route API?

It is py. Use it in the prices query and in the body of POST /api/v1/activations.

Do I store Paraguayan numbers with the 09 prefix?

No. Drop the domestic 0 and store +595 followed by the nine-digit national number.

How much does a +595 number for testing cost?

A Paraguayan activation runs from $0.20 per code depending on the service, and the wallet is debited only for a code that actually lands.

Can I test a Spanish-language sign-up flow for Paraguay without a local SIM?

Yes. Order a Paraguay verification number on the OTP Gateway and read the code in the dashboard or through the API.

Will codes arrive in Guaraní?

Rarely, if ever. International services usually send Spanish or English text, so parse just the digits.

What happens to my money if the activation expires?

When no SMS arrives within the 20-minute window, the full amount goes back to your wallet automatically.

Service names are trademarks of their respective owners. OTP Route is not affiliated with them. Use numbers lawfully, follow each service's terms and our Acceptable Use Policy.