FIDO Authentication
FIDO 认证
什么是 FIDO 认证
支持场景概览
| 商户场景 | 支持方式 | 是否支持 FIDO 通行密钥 |
|---|---|---|
| 原生 App（iOS） | ASWebAuthenticationSession（推荐） SafariViewController（有限支持） | ✅ |
| 原生 App（Android） | Chrome Custom Tab | ✅ |
| 网站（PC 浏览器） | Chrome、Safari、Edge、Firefox | ✅ |
| 网站（移动浏览器） | 主流移动浏览器 | ✅ |
| App 内嵌 WebView | iOS WKWebView、Android WebView | ❌ 不支持 |
FIDO 方案
FIDO 认证注册流程
paymentMethod 请求创建令牌；通过 payment 请求在支付时创建令牌。FIDO 认证身份识别流程
FIDO 认证接入
步骤 1：采集附加参数
步骤 2：发起支付或令牌化
/g2/v1/payment/mer/{sid}/payment/g2/v1/payment/mer/{sid}/paymentMethod| Body 参数 | 是否必填 | 说明 |
|---|---|---|
| authentication | M | 支付或令牌化前用于用户认证的信息。 |
| transInitiator | C | 支付时必填。 支付或令牌化前用于用户认证的信息。 |
| userInfo | C | 支付时必填。 支付或令牌化前用于用户认证的信息。 |
| returnURL | M | 用户完成认证后，重定向回商户的 URL。 |
| allowAuthentication | O | 门店配置为可选认证时适用。用于 POST /g2/v1/payment/mer/{sid}/payment 或 POST /g2/v1/payment/mer/{sid}/paymentMethod 请求，表示该笔支付是否需要认证。 |
authentication 对象详细说明：1.
authentication.type：该笔支付使用的认证模式，可选。需要设为 FIDOPage、threeDSPageOrFIDOPage 或 threeDSIntegratorOrFIDOPage，告知 EVO Cloud 使用 FIDO 认证的重定向方案。| authentication.type | 说明 |
|---|---|
| FIDOPage | 该交易使用 EVO Cloud 认证页面，进行 Mastercard SCOF（Secure Card on File，安全卡信息存储）TAS（Token Authentication Services，令牌认证服务）认证。 |
| threeDSPageOrFIDOPage | 该交易使用 EVO Cloud 认证页面进行 3DS 认证，或使用 EVO Cloud 认证页面进行 Mastercard SCOF TAS 认证。具体采用哪种由 EVO Cloud 自动判断。 |
| threeDSIntegratorOrFIDOPage | 该交易通过与 EVO Cloud 的全 API 对接进行 3DS 认证，或使用 EVO Cloud 认证页面进行 Mastercard SCOF TAS 认证。具体采用哪种由 EVO Cloud 自动判断。 |
transInitiator 对象详细说明：1.
transInitiator.userCreateIP：用于标识设备的唯一字符串，支持 IPv4 或 IPv6。2.
transInitiator.latitude 和 transInitiator.longitude：可选，填写用户发起支付时所用设备的纬度和经度。FIDO 认证时必填，除非用户拒绝共享位置。userInfo 对象详细说明：1.
userInfo.mobilePhone：用户手机号。未提供邮箱（userInfo.email）时必填。2.
userInfo.email：用户邮箱地址。未提供手机号（userInfo.mobilePhone）时必填。result.code 和 payment.status / paymentMethod.token.status 向用户展示支付 / 令牌化结果。action 对象发给 Web 前端或客户端 App，然后进入下一步。以下为需要重定向的支付应答示例：步骤 3：处理 redirectUser
redirectUser。这表示你需要使用同一应答中的 action.redirectData，把用户重定向到 EVO Cloud 托管页面完成 FIDO 认证。A. 将用户重定向到 EVO Cloud 托管页面
action.redirectUser.method 指定的 HTTP 方法，把用户重定向到 action.redirectUser.url。action.redirectUser.method 为 GET 时，在前端执行 redirectUser 操作的示例：iOS App 接入
Android App 接入
B. 用户完成认证后重定向回商户
步骤 4：展示结果
result.code 和 payment.status / paymentMethod.status 告知用户支付或令牌化的状态。| 结果码 | 说明 |
|---|---|
S0000 | 成功 |
V0007 | Missing field {} when {...}（在 {...} 条件下缺少字段 {}） |
B0025 | 认证未完成 |
B0026 | 不支持该 3DS 版本 |
result.code 值及建议向用户展示的提示信息，见 EVO Cloud API 规范附录。result.code 为 S0000，还需要检查 payment.status / paymentMethod.status，确定支付或令牌化的状态并告知用户。| 状态（payment） | 说明 |
|---|---|
| Authorised | 用于卡交易，表示交易授权已成功，等待完成（商户可发起撤销）。 |
| Captured | 卡交易表示授权和完成均已成功。 |
| Failed | 支付失败。 |
| 状态（paymentMethod） | 说明 |
|---|---|
| Success | 令牌已创建。 |
| Failed | 令牌创建失败。 |
payment.status / paymentMethod.status 值及说明，见 EVO Cloud API 规范中的 payment.status / paymentMethod.status 部分。