English
Guatemala (+502) Verification Numbers for Testing and Operations
Yes, OTP Route can receive Guatemalan (+502) SMS verification codes on a one-time number from its OTP Gateway, and you read each code in the dashboard or collect it through the API and signed webhooks. Codes start from $0.20 per code, the live price for every service is shown before ordering, and if nothing arrives within 20 minutes the charge is returned to your wallet.
What makes Guatemala worth a dedicated test run?
Guatemala is the most populous country in Central America, and for many teams it is the first market on a regional Spanish-language rollout. Spanish is the official language, while a large share of the population also speaks one of the many Mayan languages, which matters if your onboarding copy or support content goes beyond Spanish.
Three situations come up repeatedly:
- Regional launches that need the phone-entry screen, the Spanish SMS wording and the verification step checked on a real +502 route (mobile app verification).
- Diaspora products such as remittance or calling apps used by Guatemalans living in the United States, where the account is tied to a home-country number.
- Operations teams managing business profiles for Guatemalan clients who prefer not to link anyone's personal phone (operations teams).
How are Guatemalan phone numbers formatted?
Guatemala uses eight-digit national numbers and has no trunk prefix, so there is no leading zero to strip. The E.164 form is simply +502 followed by those eight digits, written as +502 xxxx xxxx.
That short length trips up form validators written with ten-digit North American numbers in mind. Add test cases for an eight-digit entry, for users who type the 502 without the plus sign, and for spaces or dashes in the middle. Store the normalized E.164 string and avoid guessing whether a number is mobile or fixed from its length alone, because both share the same eight digits.
Can I receive Guatemala SMS OTP codes through the API?
Yes. The Guatemala OTP API uses the country id gt against the base URL https://otproute.com/api/v1, authenticated with a Bearer key prefixed or_live_.
Start with GET /api/v1/services to find the service id, then check the current quote with GET /api/v1/prices?country=gt&service=<id>. Create the number using POST /api/v1/activations and the body {"service": "<id>", "country": "gt"}. Once your app sends the SMS, either poll GET /api/v1/activations/{id} or let a webhook endpoint receive activation.sms_received. Verify the X-OTPRoute-Signature header, an HMAC-SHA256 over the timestamp and raw body, and reject stale timestamps, as described in securing OTP webhooks. The developer overview lists limits: 10 keys, 5 webhook endpoints, 300 requests per minute.
Which services are on the +502 route right now?
More than 1,600 services are listed for Guatemala. The current snapshot of popular ones includes WhatsApp, Facebook, TikTok, Telegram, Instagram, Google (Gmail & YouTube), X (Twitter), Uber, Amazon, Discord, LinkedIn, Signal, Netflix and Microsoft & Outlook. Stock rotates through the day, which is why the API returns live availability rather than a fixed catalog.
Is there a no-code path for support and ops staff?
Anyone on the team can order from the dashboard after you sign up with email and a 6-digit code or Google sign-in. Choose Guatemala, pick the service, confirm the price shown, and copy the +502 number into the app. The code appears on the same screen when it arrives. Turning on two-factor (TOTP) for the OTP Route account itself is a sensible step for shared team access.
Why did my +502 code not show up, and what should I try?
The number stays active for 20 minutes, and the charge applies only when a code is delivered. If the window expires or you cancel, the full amount returns to the wallet automatically.
- Wait out the window; delivery time depends on the service and the route.
- Try again later, or through another service route if one is offered.
- Confirm the service accepts virtual numbers, since some refuse them.
- Do not fire new orders in a tight loop; back off between attempts.
What about long-term Guatemalan numbers, billing and sandbox?
A self-serve long-term Guatemalan number does not exist on OTP Route. Dedicated lines are only for the United States and Canada, from $1.95/month. If you need a lasting +502 line, email [email protected]; whether anything can be arranged depends on local rules and is not assured.
Payment runs through one prepaid USD wallet with no plan or monthly fee, topped up by card or USDT/USDC, with a PDF invoice emailed for each top-up. For integration work, a development account can be switched to sandbox on request so simulated numbers and codes flow through your code at no cost.
Frequently asked questions
Can I check our Spanish-language sign-up for Guatemala without a local SIM?
Yes. Order a gt number on the OTP Gateway, enter it in your app, and read the Spanish code in the dashboard or from your webhook.
Do Guatemalan numbers need a leading zero?
No. Guatemala has no trunk prefix, so a number is just +502 plus eight digits.
What is the cheapest a +502 code can cost?
Prices start from $0.20 per code; the figure for a specific service is returned by GET /api/v1/prices and shown before you confirm.
Will I be charged if the verification SMS never comes?
No. Without a delivered code inside the 20-minute window, or after a cancel, the full amount goes back to the wallet.
Can OTP Route keep the same +502 number for my team long term?
Not through self-serve. OTP Gateway numbers handle a single code, and long-term lines are US and Canada only, so ask [email protected] about Guatemala.
Which rules apply to how we use these numbers?
Each service's own terms plus the OTP Route Acceptable Use Policy. Use the numbers only to test or run your own legitimate products and business accounts.
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.