French Guiana (+594) verification numbers for developers and QA

One code or a number you keep: what does French Guiana support?

Before writing any code, decide which product the job needs.

• OTP Gateway fits one-off verifications: confirming your sign-up flow accepts a French Guiana verification number, a regression run before a release, or setting up a regional business profile once. Each number is used for a single code.
• Dedicated Virtual Numbers fit accounts that must keep receiving codes, such as a staging login your QA team opens every week. These are sold instantly only in the United States and Canada, from $1.95/month.

French Guiana falls in the first group. There is no self-serve long-term +594 line; if your team needs one, write to [email protected], and availability depends on local rules. The comparison of temporary vs dedicated numbers helps when you are unsure which side a task falls on.

How does the French Guiana OTP API sequence run?

French Guiana's country id is gf. With a Bearer key (prefix or_live_) against https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> returns the live price and shows whether the route is open.
2. POST /api/v1/activations with {"service": "facebook", "country": "gf"} reserves a +594 number and returns an activation id.
3. Your test submits the number in the app under test.
4. The code reaches you through activation.sms_received on a webhook, or through GET /api/v1/activations/{id} if you poll.
5. POST /api/v1/activations/{id}/cancel releases an order the test no longer needs.

Webhook requests include X-OTPRoute-Signature in the form t=<unix>,v1=<hex>. Compute HMAC-SHA256 of "<t>.<raw body>" with the endpoint secret, compare in constant time, refuse stale timestamps, and dedupe on the activation id. Limits per account are 10 API keys, 5 webhook endpoints and 300 requests per minute; the full reference is in the docs.

Why do +594 numbers confuse phone validation?

French Guiana is an overseas region of France and follows the French numbering plan, but it has its own country code, +594, rather than France's +33. Domestically, numbers have ten digits with a leading 0: mobiles typically start with 0694 and fixed lines with 0594. Internationally the 0 is dropped, so a mobile becomes +594 694 XX XX XX.

That arrangement produces a few classic bugs, and a +594 number for testing is the easiest way to catch them:

• A country picker that lumps French territories under France and prepends +33 to a 0694 number.
• Phone libraries that report the region as GF while your business logic only knows FR.
• Display code that formats in French digit pairs but saves the formatted string instead of E.164.

Store +594… without spaces and keep region and country as separate concepts in your data model.

Which apps can send verification codes to French Guiana numbers?

More than 700 services are currently available on the French Guiana route. The live snapshot includes WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber and LinkedIn.

The SMS text is usually French, matching the language most local accounts use, but services choose their own templates, so extract the digits instead of matching a phrase. Teams test here when localizing French-language flows beyond metropolitan France, serving customers in the French overseas regions, or checking that a regional account still verifies after a configuration change.

How does someone order a +594 number from the dashboard?

No code is required:

1. Register with your email plus a 6-digit email code, or with Google sign-in, and enable TOTP two-factor while you are there.
2. Fund the wallet by card or with USDT/USDC.
3. Choose French Guiana and the service; the price is displayed before you confirm.
4. Paste the number into the app, then watch the activation page for the code.

Operations staff and agency account managers usually take this route, while engineers wire up the API. Both draw on the same wallet.

What happens when the code never comes?

Activations last 20 minutes. Payment is only taken if the code arrives; a cancelled order, or a window that closes without an SMS, returns the full amount to the wallet automatically.

If you are waiting on a +594 code:

• Let the window finish; a service can be slow without anything being wrong.
• Check whether the service accepts virtual numbers. Some don't, and the refund exists for exactly that case.
• Retry later or choose another service route.
• Resist scripting instant re-orders after each miss; an exponential backoff keeps the +594 route usable for everyone.

Our notes on reducing failed OTP deliveries go further. Keep French Guiana testing to products and accounts your team owns, honor each service's terms, and treat OTP Route's Acceptable Use Policy as part of the deal.

How are payments, invoices and sandbox testing handled?

OTP Route runs on a prepaid USD wallet: pay as you go, no monthly fee, no plan. Funding happens by card or with USDT/USDC stablecoins, and an emailed PDF invoice follows every top-up for your accounts team. Current rates are listed on the pricing page.

Engineers wiring up the gf flow can ask support to flip a development account into sandbox. It returns simulated numbers and codes, so the +594 flow, webhook verification and retry logic can all be exercised end to end without spending wallet funds. From the API's point of view, OTP routing to French Guiana is no different from any other market: only the country id changes, while the SMS verification API stays the same.

Frequently asked questions

Can I test my app's French Guiana sign-up without a local SIM?

Yes. Order an OTP Gateway number for gf, submit it in your sign-up form, and read the code in the dashboard or from your webhook.

Is a French Guiana number the same as a French +33 number?

No. French Guiana uses the French numbering plan but has its own country code, +594, and phone libraries treat it as a separate region.

What does a +594 code cost?

From $0.20 per code, varying by service; the dashboard and GET /api/v1/prices show the live price. No SMS within 20 minutes means an automatic refund.

Can I keep a French Guiana number for later logins?

There is no self-serve option. Long-term Dedicated Numbers are limited to the US and Canada; email [email protected] to ask about +594.

What language do the codes arrive in?

Usually French, though each service picks its own template and may follow the account's language setting.

Can I test the integration before funding the wallet?

Ask for sandbox mode on a development account. It simulates numbers and codes so you can try the full flow without spending anything.

Why didn't my French Guiana code arrive?

The service may be slow, may reject virtual numbers, or the route may be busy. Wait out the window, then retry later or on another route; failed orders are refunded.

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.