English
Choosing how to receive Tongan (+676) verification codes
Yes, you can receive Tonga (+676) verification codes with OTP Route: order a one-time OTP Gateway number, then read the code in the dashboard or collect it through the API by polling or a signed webhook. Codes cost from $0.20 per code, and nothing is charged if the SMS fails to arrive within 20 minutes.
Gateway number or long-term line: what fits a Tonga project?
Start with the shape of the job. If you need to watch one SMS code arrive, for a sign-up test, a localisation check or a support reproduction, the OTP Gateway is the right product. You get a +676 number for one verification, the code lands in the dashboard and your systems, and the activation closes.
If instead you need a number that stays with an account for months, to log in again, receive recovery codes or run a support line, that is a job for Dedicated Virtual Numbers. Those are available only in the United States and Canada, from $1.95/month, with inbound and outbound SMS and calling from the browser.
OTP Route has no self-serve long-term Tongan line. Teams that need one can email [email protected] to ask, knowing that availability depends on local rules and may not be possible. More on the trade-off is in temporary vs dedicated numbers.
Why would anyone test a sign-up flow against Tongan numbers?
Tonga has a large diaspora, much of it in New Zealand, Australia and the United States, and families stay in touch across those countries through messaging apps and money-transfer services. Products that serve Pacific communities, such as remittance tools, community platforms and travel services, need to accept a +676 number as confidently as a +64 one.
That makes Tonga a useful edge case in QA. Tongan and English are both official languages, and most verification texts from international apps arrive in English, so the interesting bugs tend to be in number handling rather than message wording. Teams building fintech onboarding for Pacific corridors often add a Tonga case to their regression suite for exactly this reason.
How should validators treat +676 numbers?
Tongan national numbers are much shorter than the European or American numbers most developers have in their heads, and there is no trunk prefix in international form. Validation code with a fixed minimum length is the most common way these numbers get rejected.
- Store every number in E.164,
+676followed by the subscriber digits, and never pad it. - Rely on an up-to-date phone-number library rather than a regex copied from another country.
- Make sure your SMS sender does not silently drop recipients whose number looks too short.
- Keep a Tonga verification number in your fixture set so a future refactor can't reintroduce the bug.
A one-off +676 order from the Gateway is a cheap way to confirm the whole path works with a real carrier-delivered SMS.
Which services does the Tonga route cover?
The Tongan route currently lists more than 600 services. Popular ones in the latest snapshot include Facebook, TikTok, Viber, WhatsApp, Instagram, Telegram, Google (Gmail & YouTube), Snapchat, Microsoft & Outlook and Amazon.
The list changes through the day as capacity moves between routes. Treat it as a guide and check live availability before ordering, either in the dashboard or through the prices endpoint.
How do you call the Tonga OTP API?
Authenticate against https://otproute.com/api/v1 with a Bearer key starting or_live_ from the Developer console. Tonga's country id is to.
Check price and stock with GET /api/v1/prices?country=to&service=<id>, then place the order with POST /api/v1/activations and a body such as {"service": "viber", "country": "to"}. The response returns an activation id and a +676 number.
To receive Tonga SMS OTP codes automatically, register a webhook for activation.sms_received and activation.expired. Each request includes X-OTPRoute-Signature: t=<unix>,v1=<hex>; recompute HMAC-SHA256 over <t>.<raw body> with your endpoint secret, compare in constant time, and refuse old timestamps. Polling GET /api/v1/activations/{id} is fine for small jobs, and POST /api/v1/activations/{id}/cancel releases an order you no longer need. Limits are 300 requests per minute, 10 keys and 5 webhook endpoints per account. See the developer docs for request and response details.
What can you do when a Tongan code is slow or missing?
Thin routes are normal in small island markets, so build the retry policy before you need it.
- Let the 20-minute window finish; the order is refunded in full if no SMS lands.
- Check whether the service you are testing accepts virtual numbers. Some do not, and no route will change that.
- Wait before trying again instead of placing new orders back to back.
- If the test is about Pacific numbers in general, try a nearby route such as Fiji or Samoa.
Remember that every order must respect the target service's terms and OTP Route's Acceptable Use Policy.
How do billing and sandbox testing work?
OTP Route uses a single prepaid USD wallet with pay-as-you-go pricing, so there is no monthly fee and no plan to pick. Add funds by card or with USDT/USDC stablecoins, and each top-up is followed by a PDF invoice by email. Developers still building the flow can request sandbox mode for a development account, which returns simulated numbers and codes so OTP routing logic and webhook handlers can be tested without touching the wallet. Current per-code figures are on the pricing page.
Frequently asked questions
Can I receive a Tongan verification code without being in Tonga?
Yes. Order a +676 number from the OTP Gateway and the code is shown in your dashboard and sent to your webhook, wherever your team is.
What country id does the SMS verification API use for Tonga?
The id is to, used in GET /api/v1/prices and POST /api/v1/activations.
Why does my form reject valid Tongan numbers?
Usually a minimum-length check written for longer numbers. Validate with a maintained phone-number library and store numbers in E.164.
Is there a long-term +676 number I can keep?
Not self-serve. Long-term Dedicated Numbers are offered only in the US and Canada; email [email protected] to ask about Tonga.
What happens to my money if the Tongan code doesn't arrive?
The full amount returns to your wallet automatically when the 20-minute window closes without an SMS, or when you cancel.
Can I test my app's Tongan onboarding in CI?
Yes. Use an API key per environment, poll or listen for webhooks, and switch a development account to sandbox while you build the pipeline.
In which language do Tongan verification texts arrive?
Most international apps send English, though it depends on the service and the account's language setting.
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.