LAAFFIC 产品页描述的是 Standard Flashcall，而不是 Reverse flash call 或 Voice OTP。

已确认流程：服务端向用户发起 1–3 秒短时来电，自动断开，用户无需接听；来电号码末 4–6 位作为验证码；Android 场景下应用可读取通话记录并自动填入。产品页声明大多数情况下验证可在 5 秒内完成，但上线前仍需根据目标市场实测。

Standard Flashcall

• 服务端呼叫用户；
• 来电响 1–3 秒后自动断开；
• 用户不需要接听；
• 来电号码末 4–6 位用于验证；
• Android 应用可在支持条件下读取通话记录并自动填充。

Reverse flash call

• 用户主动拨打服务号码；
• 系统识别主叫号码；
• 适合需要减少应用读取来电记录依赖的部分流程；
• 不应将其实现方式直接套用到 LAAFFIC，除非获得官方确认。

Voice OTP

• 服务端呼叫用户；
• 用户接听电话；
• 语音播报验证码；
• 用户通常需要手动输入验证码。

用户端流程

1. 用户输入手机号

2. 前端校验国家代码和号码格式

3. 用户点击“获取验证码”

4. 页面显示 Flashcall 正在验证，并明确提示用户无需接听

5. Android 支持自动识别时，应用读取通话记录并填充验证码

6. 无法自动识别时，进入人工输入或备用渠道流程

7. 验证成功后创建会话、完成注册或继续原业务动作

服务端流程

1. 创建验证会话

2. 生成唯一的业务请求标识

3. 向 LAAFFIC 发起 Flashcall 请求

4. 保存会话状态、手机号脱敏值、过期时间和渠道信息

5. 通过 FlashCall Webhook 接收呼叫状态

6. 校验结果是否属于当前用户、当前设备和当前业务会话

7. 对成功、失败、超时和回退进行统一处理

8. 写入审计日志和风控事件

LAAFFIC 官方发送字段与回调字段见本文“API 如何接入”一节。以下字段是建议由企业内部验证服务维护的会话模型，不属于 LAAFFIC 官方请求参数：

verification_session_id
masked_phone_number
channel
status
expires_at
retry_count
fallback_channel
risk_result

建议至少设计以下状态：

CREATED
REQUESTED
RINGING
AUTO_DETECTED
MANUAL_INPUT_REQUIRED
VERIFIED
TIMEOUT
BLOCKED_OR_UNDELIVERED
FALLBACK_TRIGGERED
FAILED
EXPIRED

• CREATED：用户提交手机号，系统尚未成功发起验证请求。适合执行格式校验、黑名单检查和频率限制。
• REQUESTED：系统已向供应商发起请求，尚未收到最终结果。需要设置服务端超时，避免请求长期占用。
• RINGING：LAAFFIC 的状态 Webhook 提供 ringingTime；该值非空可用于判断已经响铃。公开回调的最终 flashCallStatus 为 0（成功）或 1（失败），业务系统仍应自行维护中间状态。
• AUTO_DETECTED：Android 应用检测到通话记录，并提取到与当前会话匹配的末 4–6 位。
• MANUAL_INPUT_REQUIRED：应用无法自动读取、设备不支持或用户使用的是需要人工回退的流程。此状态不应被错误记录为“供应商失败”。
• VERIFIED：验证码或来电号码匹配当前会话，且会话未过期、未重复使用。
• TIMEOUT：在规定时间内没有完成验证。可触发 SMS OTP 或 Voice OTP，但应限制回退次数。
• BLOCKED_OR_UNDELIVERED：系统判断或推测来电被拦截、未送达或无法完成识别。具体判定需要供应商事件或内部超时策略支持。

建议的基本策略

1. 发起一次 Flashcall；
2. 在短时间窗口内等待自动识别或验证结果；
3. 超时后允许一次受控重试；
4. 若仍未完成，触发 SMS OTP 或 Voice OTP；
5. 对连续失败、短时间大量请求和高风险行为进入风控流程。

不要无限重试

无限重试可能导致：

• 用户收到多次陌生来电；
• 运营商或设备进一步拦截；
• 供应商成本增加；
• 攻击者利用接口进行资源消耗；
• 用户误以为账户遭到骚扰。

应按手机号、设备、IP、账户和业务动作设置独立频控，并区分正常重试与风险重试。

级联不是简单的自动切换

建议为每个市场建立渠道策略：

不要将 Flashcall 宣传为能够绕过所有 SMS 过滤。更准确的说法是：Flashcall 使用语音通道，可以减少对短信通道的依赖，但可能受到当地运营商、地区政策、设备设置和来电拦截影响。

LAAFFIC 产品页说明 Android 应用可以读取通话记录、填入验证码并自动完成验证。开发团队仍需确认以下条件：

• 应用所需权限；
• 目标 Android 版本；
• 手机厂商对通话记录的限制；
• 用户拒绝权限后的回退流程；
• 双卡设备的号码识别逻辑；
• 来电号码格式化和国家代码处理；
• 用户同时收到多通来电时的匹配规则；
• 应用在后台、锁屏或省电模式下的行为。

LAAFFIC 的产品说明已经明确：iOS 受系统限制，不能像 Android 一样由 App 自动读取通话记录，用户需要手动查看来电记录。因此，iOS 流程应按“人工输入 + 明确回退”设计，不能宣传为零操作自动验证。

• 提示用户无需接听，并查看来电记录中的号码；
• 提供末 4–6 位数字的人工输入框和清晰的错误提示；
• 达到业务设定的超时阈值后，切换 SMS OTP 或 Voice OTP；
• 纯网页流程不适用 LAAFFIC 所述的 App 自动读取方案；
• 按 iOS 版本、专注模式、陌生来电静音和拦截设置进行兼容测试；
• 用户接听、忽略或拦截来电时如何处理；
• 记录手动输入成功率、超时率和回退率，单独评估 iOS 转化。

清晰文案可以降低用户误接、拒接或误解的概率。

推荐文案

不推荐文案

• “请接听电话获取验证码”；
• “Flashcall 一定不会被拦截”；
• “任何手机都能自动完成验证”；
• “无需任何权限即可自动读取通话记录”；
• “Flashcall 在所有国家都比 SMS 更可靠”。

如果某个设备不支持自动识别，应在界面中提供明确的人工输入按钮，并说明回退渠道，而不是让用户一直等待。

Flashcall 验证手机号控制权，但不等于完成全部身份认证。服务端至少应考虑以下控制：

• 会话绑定：验证码必须绑定手机号、业务会话、设备或登录请求，不能只校验一串数字是否正确。
• 有效期：验证码和验证会话应设置有效期，成功后立即失效。具体有效期需根据业务和供应商能力确认。
• 幂等处理：同一请求可能因网络重试、客户端重复点击或回调重复被处理多次。应使用业务请求标识和幂等规则，避免重复创建账户或重复放行支付。
• 频率限制：按手机号、账户、设备、IP、国家和运营商、业务动作、时间窗口等维度设置限流。
• 风险信号：与 IP 信誉、设备指纹、代理检测、模拟器识别、手机号历史、行为速度和账户风险结合使用。

Flashcall 可以用于支付确认、修改手机号、修改支付信息和其他高风险操作，但建议将其视为手机号控制权验证，而不是唯一的强认证因素。

• 低风险设备：Flashcall 成功后继续；
• 新设备或异常 IP：Flashcall 成功后追加 SMS、Push 或人工审核；
• 高金额支付：增加交易密码、设备确认或其他强认证；
• 多次失败：冻结短期重试并进入风险审查；
• 号码刚变更：延迟敏感操作或要求额外验证。

具体安全等级和认证因素应根据业务风险评估确定。

功能测试

• 正确手机号可以发起验证；
• 错误国家代码会被拦截；
• 来电号码末 4–6 位匹配成功；
• 验证码错误时不会放行；
• 过期会话不能再次使用；
• 重复点击不会创建多个无效会话；
• 成功后验证码立即失效。

设备测试

• 不同 Android 版本、不同手机厂商；
• 双卡设备、锁屏和后台状态；
• 来电拦截应用开启、用户拒绝通话记录权限；
• iOS 手动输入或替代流程。

网络和运营商测试

• 不同国家、不同运营商、不同时间段；
• 漫游用户、低信号环境、来电延迟；
• 来电未送达、用户误接电话。

安全测试

• 高频请求、并发请求；
• 验证码重放、回调重复；
• 会话劫持、手机号枚举；
• 恶意触发 SMS 回退、设备和 IP 轮换攻击。

建议按国家、运营商、设备、操作系统和业务场景拆分指标：

• Flashcall 发起量、来电送达或可观测成功量；
• 自动识别成功率、手动输入成功率；
• 平均验证时间、P95 验证时间；
• 超时率、回退率、重试率、用户主动接听比例；
• 风控拦截率、每个成功验证用户的总成本；
• 注册或登录完成率。

当前公开发送接口为 POST https://api.laaffic.com/v3/voice/flashcall，请求头包含 Content-Type: application/json;charset=UTF-8、Sign、Timestamp 和 Api-Key。

{
  "appId": "rtnrc",
  "callee": "639191700000",
  "maxRingingTime": 15,
  "flashCallValidDuration": 30
}

• appId：必填，语音应用 ID；
• callee：必填，国码 + 手机号组成的 7–18 位数字；
• maxRingingTime：可选，最大响铃时长，默认 60 秒，范围 1–120 秒；
• flashCallValidDuration：可选，闪呼有效时长，默认 60 秒，范围 30–600 秒；超过该时长仍未呼出则不再呼出。

成功响应返回 status: "0"、reason: "success" 和 data.voiceId。公开错误码包括账号认证异常（-1）、IP 限制（-2）、时间戳过期（-16）、系统异常（-18）、数据重复（-20）、参数错误（-22）、数据上限（-23）、WorkSpace 不匹配（-63）和需联系客户经理（-75）。

在控制台配置 Voice - FlashCall Callback URL 后，平台以 HTTP POST 推送数组，字段包括 voiceId、callee、displayNum、submitTime、callTime、ringingTime 和 flashCallStatus（0 成功、1 失败）。回调接收端返回 HTTP 200 即可，仍应自行实现验签/来源校验、去重、重放防护和幂等处理。

注意：产品方案中的 POST /v1/misscall/verify 是说明业务编排的示意接口，不应替代官网 API 中心当前公布的 /v3/voice/flashcall。多通道方面，Flashcall 由业务侧显式调用；SMS 与 Voice OTP 支持平台底层自动互切，Flashcall 失败后切换到 SMS/Voice 的阈值应由业务规则配置。

正式上线前仍需向 LAAFFIC 确认账户级参数：

• 签名算法、密钥轮换、IP 白名单及回调来源校验
• 频控、并发、幂等、可重试错误和重试上限
• 沙箱、测试号码、测试余额和账单/用量接口
• 各市场 Flashcall → SMS/Voice OTP 的超时阈值；方案中的 8 秒为推荐示例
• 日志、数据保留、脱敏、删除与本地合规要求

在正式上线前，建议由产品、研发、安全、运营和采购共同确认以下问题：