通过 SSN 验证

向 Fluz 传递 SSN 信息是两种 API 方法中更直接的一种。你从客户处收集一小组身份字段并提交，Fluz 会在同一响应中返回决策。当你已经持有（或可以合理索取）客户的身份详情时，将其作为首选 API 尝试。如果被拒绝，升级为请求 IDV URL。

先决条件

由 Fluz 在你的应用上启用 VERIFY_KYC scope。参见所需 scope。
为待验证客户生成的用户访问令牌，其 scopes 中包含 VERIFY_KYC。
已注册的 webhook 端点。参见验证客户。

工作原理

verifyUserInformation 变更是同步的。你提交客户信息，Fluz 会与在档身份数据进行比对，并在响应体中返回 APPROVED、DECLINED、DUPLICATE 或 ERROR。此流程无面向客户的步骤，客户无需完成任何操作。 Fluz 还会向你的 webhook 端点发送验证事件，因此单一处理器即可一致地处理所有验证方法的结果。

请求

被验证的客户由 Authorization 头中的用户访问令牌标识——你无需在输入中传递用户 ID。

字段	类型	必填	说明
`firstName`	String	是	客户的法定名。
`lastName`	String	是	客户的法定姓。
`streetLine1`	String	是	居住街道地址。
`streetLine2`	String	否	公寓、套房或单元号。不使用时传空字符串。
`city`	String	是	城市。
`state`	String	是	州或地区。
`postalCode`	String	是	邮政编码。
`country`	String	是	国家。
`dateOfBirth`	String	是	出生日期，格式为 `MM/DD/YYYY`。
`ssnLast4`	String	是	客户 SSN 的后四位。

Fluz 接受完整 SSN 或仅后四位。建议仅提交后四位——可获得相同的决策，同时减少你需要收集和存储的数据。

提交客户的居住地址，而非账单或邮寄地址。邮政信箱将被拒绝。地址不匹配是假性拒绝的最常见原因——参见地址格式要求。

示例

import { GraphQLClient, gql } from 'graphql-request';

const API_URL = 'https://transactional-graph.fluzapp.com/api/v1/graphql';

const VERIFY_USER_INFORMATION = gql`
  mutation verifyUserInformation($input: VerifyUserInformationInput!) {
    verifyUserInformation(input: $input) {
      status
      message
    }
  }
`;

const client = new GraphQLClient(API_URL, {
  headers: {
    Authorization: `Bearer <<USER_ACCESS_TOKEN>>`,
    'Content-Type': 'application/json',
  },
});

const response = await client.request(VERIFY_USER_INFORMATION, {
  input: {
    firstName: 'John',
    lastName: 'Smith',
    streetLine1: '123 Main St',
    streetLine2: '',
    city: 'Los Angeles',
    state: 'CA',
    postalCode: '91234',
    country: 'United States',
    dateOfBirth: '01/28/1975',
    ssnLast4: '1234',
  },
});

console.log(response);

Response

{
  "data": {
    "verifyUserInformation": {
      "status": "APPROVED",
      "message": "User verification successful"
    }
  }
}

打开示例配方

可复制运行的示例版本，便于你根据集成进行改造。

处理响应

状态	处理措施
`APPROVED`	客户已通过验证。解锁相关功能。
`DECLINED`	升级为证件验证。不要重新提交相同信息。
`DUPLICATE`	客户已通过验证，但其SSN 与另一位 Fluz 客户匹配。视为已验证，并在你方审查是否为重复账户。Fluz 不会披露匹配的是哪位客户。
`ERROR`	检查 `message`。客户要么已验证过，要么已用尽尝试次数。

客户最多可进行 SSN 验证3 次。第三次之后，后续请求将返回 ERROR 且为 Exceeded user verification limit。请将客户转到证件验证，而非继续重试。

测试

预发布环境的测试身份会返回特定、可预测的结果代码，因此你可以在不使用真实数据的情况下，演练如地址不匹配、死亡主体、薄档案、无效 SSN 等拒绝情形。参见测试 KYC 流程。

请勿修改测试身份数据。任一字段未与预期测试值匹配时，将返回不匹配结果，而非你试图演练的结果代码。

​工作原理

​请求

​示例

打开示例配方

​处理响应

​测试

工作原理

请求

示例

处理响应

测试