通过 SSN 验证

将 SSN 信息传递给 Fluz 是两种 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 流程。

不要修改测试身份数据。任何与预期测试值不一致的字段都会返回不匹配，而非你试图演练的结果代码。

Home

Additional Resources

通过 SSN 验证

工作原理

请求

示例

处理响应

测试

​工作原理

​请求

​示例

​处理响应

​测试

工作原理

请求

示例

处理响应

测试