一次性验证码还是长期号码：法属圭亚那支持哪种？
动手写代码之前，先确定任务需要哪种产品。
- OTP Gateway 适合一次性验证：确认注册流程能接受法属圭亚那验证号码、发布前的回归测试，或一次性完成区域业务账号的设置。每个号码只用于接收一条验证码。
- Dedicated Numbers（专用虚拟号码） 适合需要长期收码的账号，例如 QA 团队每周都要登录的预发布环境账号。该产品仅在美国和加拿大即时开通，$1.95/月起。
法属圭亚那属于第一类。目前没有可自助开通的 +594 长期号码；如果团队确实需要，请发邮件至 [email protected]，能否提供取决于当地规定。如果拿不准某项任务该选哪一种，可以参考临时号码与专用号码的对比。
法属圭亚那 OTP API 的调用流程是怎样的？
法属圭亚那的国家 id 是 gf。使用 Bearer 密钥（前缀 or_live_）访问 https://otproute.com/api/v1：
GET /api/v1/prices?country=gf&service=<id>返回实时价格，并显示该线路当前是否可用。POST /api/v1/activations，请求体为{"service": "facebook", "country": "gf"}，预留一个 +594 号码并返回 activation id。- 你的测试把该号码提交到被测应用中。
- 验证码通过 Webhook 的
activation.sms_received事件送达；如果使用轮询，则通过GET /api/v1/activations/{id}获取。 POST /api/v1/activations/{id}/cancel用于释放测试中不再需要的订单。
Webhook 请求带有 X-OTPRoute-Signature 头，格式为 t=<unix>,v1=<hex>。请用端点密钥对 "<t>.<raw body>" 计算 HMAC-SHA256，以常数时间比较，拒绝过期时间戳，并以 activation id 去重。每个账号的上限为 10 个 API 密钥、5 个 Webhook 端点，以及每分钟 300 次请求；完整参考见文档。
为什么 +594 号码会让手机号校验出问题？
法属圭亚那是法国的海外大区，沿用法国的编号规则，但拥有自己的国家代码 +594，而不是法国的 +33。在当地拨打时号码为十位并以 0 开头：手机号通常以 0694 开头，固定电话以 0594 开头。国际格式会去掉这个 0，因此手机号写作 +594 694 XX XX XX。
这种安排会引出几类经典 bug，而用 +594 号码做测试正是最容易发现它们的办法：
- 国家选择器把法国各领地都归到法国名下，并在 0694 号码前拼上 +33。
- 手机号码库把地区识别为
GF，而你的业务逻辑只认识FR。 - 展示层按法式两位一组格式化号码，却把格式化后的字符串直接入库，而不是保存 E.164。
请把 +594… 去掉空格后存储，并在数据模型中把“地区”和“国家”当作两个独立的概念。
哪些应用可以向法属圭亚那号码发送验证码？
法属圭亚那线路目前提供超过 700 个服务。当前快照中包括 WhatsApp、Facebook、Instagram、Google（Gmail 和 YouTube）、TikTok、Snapchat、Telegram、Microsoft 和 Outlook、Amazon、Airbnb、Uber 以及 LinkedIn。
短信内容通常是法语，与当地多数账号使用的语言一致，但各服务会自行选择模板，所以请直接提取数字，而不要匹配某个固定短语。团队会在这里测试，通常是为了本地化法语流程（覆盖法国本土以外的地区）、服务法国海外大区的客户，或者在配置变更后确认区域账号仍能完成验证。
如何在控制台订购 +594 号码？
完全不需要写代码：
- 使用邮箱加 6 位邮箱验证码，或用 Google 登录来注册，并顺便开启 TOTP 双重验证。
- 用银行卡或 USDT/USDC 为钱包充值。
- 选择法属圭亚那和对应服务；确认前会先显示价格。
- 把号码粘贴到应用中，然后在激活页面查看验证码。
运营人员和代理机构的客户经理通常走这条路径，而工程师则对接 API。两者使用同一个钱包。
验证码一直没来怎么办？
激活有效期为 20 分钟。只有验证码到达才会扣费；订单被取消，或窗口结束仍未收到短信，全部金额会自动退回钱包。
如果你在等 +594 的验证码：
- 等完整个窗口；服务响应慢并不一定意味着出了问题。
- 确认该服务是否接受虚拟号码。有些服务不接受，退款机制正是为这种情况准备的。
- 稍后重试，或换一条服务线路。
- 不要在每次失败后立刻用脚本重新下单；采用指数退避，才能让 +594 线路对所有人保持可用。
我们关于降低 OTP 投递失败率的文章有更多细节。请把法属圭亚那的测试限定在团队自己拥有的产品和账号上，遵守各服务的条款，并将 OTP Route 的《可接受使用政策》视为使用约定的一部分。
付款、发票和沙盒测试如何处理？
OTP Route 采用预付美元钱包：按量付费，没有月费，也无需选择套餐。可用银行卡或 USDT/USDC 稳定币充值，每次充值后都会通过邮件发送 PDF 发票，方便你们的财务团队。当前价格见定价页面。
对接 gf 流程的工程师可以请支持团队把开发账号切换为沙盒模式。沙盒会返回模拟的号码和验证码，因此 +594 流程、Webhook 验证和重试逻辑都可以端到端演练，而不会花费钱包资金。从 API 的角度看，路由到法属圭亚那与其他任何市场没有区别：只有国家 id 不同，短信验证 API 保持不变。
常见问题
没有当地 SIM 卡，也能测试应用的法属圭亚那注册流程吗？
可以。为 gf 订购一个 OTP Gateway 号码，在注册表单中提交，然后在控制台或 Webhook 中读取验证码。
法属圭亚那的号码和法国 +33 号码是一回事吗？
不是。法属圭亚那沿用法国的编号规则，但有自己的国家代码 +594，手机号码库也将其视为独立地区。
一条 +594 验证码多少钱？
每条 $0.20 起，因服务而异；控制台和 GET /api/v1/prices 会显示实时价格。20 分钟内没有短信则自动退款。
能保留法属圭亚那号码用于以后登录吗？
目前没有自助方式。长期 Dedicated Numbers 仅限美国和加拿大；如需 +594，请发邮件至 [email protected] 咨询。
验证码是用什么语言发来的？
通常是法语，不过各服务自行选择模板，也可能跟随账号的语言设置。
在给钱包充值之前，能先测试集成吗？
可以为开发账号申请沙盒模式。它会模拟号码和验证码，让你无需花费任何费用就能跑通完整流程。
为什么我的法属圭亚那验证码没有到？
可能是服务响应慢、拒绝虚拟号码，或线路繁忙。等完窗口时间，再稍后重试或换一条线路；失败的订单会退款。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。