Picking the right tool for Costa Rican (+506) phone verification

One-time +506 number or a line you keep: which do you need?

Start with the question of how often the account behind the number will ask for a code again.

• One code, then done. A sign-up test, a launch smoke check or a single business account confirmation in Costa Rica fits the OTP Gateway. You get a +506 number for exactly one verification code, and the activation closes after that.
• Repeated logins over months. That pattern calls for a number you hold. OTP Route sells Dedicated Virtual Numbers only in the United States and Canada, from $1.95/month, with inbound SMS, outbound SMS and browser calling.

There is no self-serve long-term Costa Rican line. If your operation truly needs one, write to [email protected] and the team will look into it, but whether it can be offered depends on local rules and is not promised. For a staging account that keeps signing in, a US or Canadian dedicated number is often the practical answer when the service accepts that region.

Which apps can send codes to a Costa Rica verification number?

The Costa Rica route currently lists more than 800 services. Among the popular ones available right now are WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, Uber, Airbnb, Microsoft & Outlook, Amazon, LinkedIn, Discord, ChatGPT (OpenAI), Signal and Netflix.

Treat that list as a snapshot. Inventory moves during the day, so the dependable source is the live price and availability call rather than any page copy, including this one. Uber and Airbnb show up often in Costa Rican test plans because travel and ride flows get exercised by teams building for visitors as well as residents.

How does the Costa Rica OTP API work from request to code?

Everything runs against https://otproute.com/api/v1 with a Bearer key prefixed or_live_, generated in the Developer console. An account can hold up to 10 keys and 5 webhook endpoints, and the rate limit is 300 requests per minute.

1. Read GET /api/v1/services and GET /api/v1/countries to map names to ids. Costa Rica is cr.
2. Ask GET /api/v1/prices?country=cr&service=<id> for the live price before each order.
3. Create the activation with POST /api/v1/activations and a body such as {"service": "whatsapp", "country": "cr"}. Keep the returned activation id.
4. Type the +506 number into the sign-up screen you are testing.
5. Let your webhook catch activation.sms_received, or check GET /api/v1/activations/{id} every few seconds if you run without one.

When a Costa Rica test aborts halfway, hand the number back through POST /api/v1/activations/{id}/cancel so the wallet is credited. Webhook requests carry X-OTPRoute-Signature: t=<unix>,v1=<hex>; recompute HMAC-SHA256 over <t>.<raw body> with the endpoint secret, compare, and drop stale timestamps. Full reference lives in the docs.

Can someone without code order a +506 number?

Yes. Operations staff and agency account managers usually work from the dashboard:

1. Sign in and open the OTP Gateway.
2. Pick the service, then choose Costa Rica as the country.
3. Check the price shown before you confirm.
4. Copy the number into the app's verification form.
5. Watch the activation; the code appears on the same screen once it arrives.

The dashboard and the API share one wallet, so a QA engineer and a marketing colleague can work from the same balance without separate setups.

What should engineers know about Costa Rican numbers and SMS?

Costa Rica uses a closed numbering plan of eight-digit national numbers with no trunk prefix. In practice that means the local form and the international form differ only by the +506 country code, which makes normalisation simple: store every number in E.164 as +506 followed by the eight digits, and strip spaces or hyphens that users often type in the middle.

Spanish is the official language, so many verification messages arrive in Spanish. Build your parser to pull the digit sequence out of the body rather than matching an English phrase such as "Your code is". Teams usually test here for Spanish-language localisation across Central America, for nearshore engineering groups who need local QA coverage, and for travel or hospitality products where visitors and residents share the same sign-up flow. Our QA testing guide covers how to wire this into a release checklist.

What if a +506 code does not arrive?

Give the activation its full 20 minutes before drawing conclusions. If nothing comes in, the charge returns to your wallet automatically, the same as when you cancel.

• Retry a little later, since availability on a route changes through the day.
• Try another service route if the product supports a different sender for the same check.
• Confirm the app accepts virtual numbers at all; some refuse them, and that is precisely why the refund rule exists.
• Avoid re-ordering in a tight loop. Back off between attempts so you are not burning quota or tripping the app's own limits.

Our write-up on reducing failed OTP deliveries lists further fixes for stubborn Central American routes.

How does billing work for Costa Rica test runs?

OTP Route is pay as you go from one prepaid USD wallet, with no monthly fee and no plan to pick. Top up by card or with USDT/USDC stablecoins, and each top-up arrives with a PDF invoice by email, which keeps finance teams happy when a test budget is shared across clients. See pricing for the current overview.

For integration work before real orders, ask for your development account to be switched to sandbox: it returns simulated numbers and codes, so the full flow can be exercised end to end without touching wallet funds. Use the service only for your own legitimate accounts and products, follow each app's terms, and note that the Acceptable Use Policy applies.

Frequently asked questions

Can I test my app's Costa Rica sign-up flow without a local SIM?

Yes. Order a +506 number from the OTP Gateway, enter it in your app, and collect the code from the dashboard, a webhook or the activation endpoint.

What is the country id for Costa Rica in the OTP Route API?

It is cr, the lowercase ISO code, and it goes both into the prices query string and into the activation request body.

Do Costa Rican numbers include a leading zero?

No. Costa Rica has no trunk prefix, so you store +506 plus the eight-digit national number and nothing else.

Can I keep a Costa Rican number for repeated logins?

Not through self-serve. Long-term lines are a US and Canada product from $1.95/month; for a Costa Rican line you can email [email protected], with no promise it can be arranged.

How much does a +506 verification code cost?

From $0.20 per code, with the exact figure depending on the service. The API and dashboard both show the live price before you order.

Am I charged if the code never comes?

No. If no SMS arrives within the 20-minute window, or you cancel first, the full amount goes back to your wallet.

Can my developers rehearse the +506 integration before paying for real orders?

Yes. Yes: ask support to flip your development account into sandbox mode, where simulated +506 numbers and codes let you rehearse the whole flow.

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.