在生产环境中,银行登录支持尼日利亚和新西兰,账户核验支持尼日利亚、加纳和肯尼亚。
随着时间推移将支持更多国家/地区,Bank Verification 定价始终显示各国家/地区当前支持的功能。
Bank Verification 会将账户持有人与其他步骤已确立的身份进行比对,因此其本身不能作为身份证明。请在此步骤之前配置身份证件验证、数据库核验、问卷或
expected_details。用户绝不会自行输入待核验的姓名:Didit 始终比对该会话已验证的姓名。两种方式
两种方式提供相同类型的结果:持有人是否匹配、银行返回的持有人姓名以及掩码后的账户。各国家/地区支持的方式有所不同,一个国家/地区可以提供其中一种、两种都提供,或以任意顺序提供两种。有关账户格式、结果及沙盒测试值,请参阅账户核验。
对账单上传和微额存款作为这两种方式之后的兜底方案(
bank_statement_enabled、bank_microdeposits_enabled),且用户始终可以选择在没有银行的情况下继续。微额存款仅在同一会话中已计费的银行登录或账户核验之后提供,无需额外费用。对账单上传也包含在任一方式之后,也可以在任何国家/地区未经前置银行尝试的情况下直接提供。请参阅当用户无法验证其银行时。
用户看到的内容
在每个国家/地区中,用户从该国家/地区提供的第一种方式开始。第二种方式作为其备选方案:- 优先银行登录:银行选择器打开。其最后一行输入您的账户信息将启动账户核验。如果银行登录失败,同一行会再次出现在其他验证方式下方。
- 优先账户核验:账户表单打开,下方带有改为登录您的银行链接。
- 仅提供一种方式:用户仅会看到该方式。
按国家/地区选择方式
步骤顺序
对于未自行设置方式的每个国家/地区,bank_method_order 用于设置该步骤提供哪些方式以及按何种顺序提供。它列出 open_banking、account_lookup 或两者兼有,排在前面的方式优先展示。
bank_method_order,其默认值为 ["open_banking", "account_lookup"]:优先银行登录,账户核验作为备选方案。空列表会被拒绝并提示 Choose a method: bank sign-in, account check, or both.。
步骤顺序是一个默认值。在某个国家/地区中,若没有通道支持其中某种方式,该方式将被排除,该国家/地区仅提供其余方式。如果某个国家/地区有通道支持,但步骤顺序设置导致其没有可用方式,保存时将被拒绝,例如 Choose a method: bank sign-in, account check, or both. ARE offers account check.。完全没有银行通道支持的国家/地区仍会保留,但仅提供其兜底方案:请参阅没有银行通道支持的国家/地区。
国家/地区专属顺序
bank_countries 中某个国家/地区的 methods 会覆盖该国家/地区的步骤顺序。用户从第一种方式开始,第二种方式作为备选方案提供。
methods 设置为 null 或缺少该键的国家/地区将遵循步骤顺序。当已启用的国家/地区出现以下情况时,保存将在 bank_countries.<ISO3> 下被拒绝:
- 将
methods设置为空列表,即使在没有通道支持的国家/地区也是如此,或 - 指定了当地没有通道支持的方式,例如
Account check is not available in NOR.
methods 或将其设置为 null,且仅提供其兜底方案:请参阅没有银行通道支持的国家/地区。
在控制台中
在银行验证步骤中,国家/地区与方式列出了每个国家/地区中银行登录和账户核验各自的支持情况,以及哪种方式优先。其预设可以一次性填充所有国家/地区:
预设绝不会让某个国家/地区没有任何可用方式:如果某个国家/地区仅支持这两种方式中的一种,该方式将保持启用状态。
财务数据需要银行登录
只有银行登录才能读取余额、交易和收入。当该步骤在bank_scopes 中请求这些数据,并且某个国家/地区提供了账户核验时,通过账户核验进行验证的人无需这些数据即可通过。该步骤不会失败:结果会在 financial_data.not_collected 中列出未收集的内容。
not_collected 就是一个空列表。如需强制要求提供这些数据,请在需要它们的国家/地区仅提供银行登录。
账户核验设置
这些键仅用于配置账户核验。银行登录保留其自身的设置。
尝试次数按验证方法分别计算。
bank_max_attempts 计算银行登录尝试次数,小额打款或对账单上传也会消耗其中一次尝试次数。bank_account_check_max_attempts 计算账户核验次数。一旦仍向该用户提供的每种验证途径(包括对账单上传)都用尽了尝试次数且未成功建立连接,该步骤将以 bank_attempts_exhausted_action 结束:参见对账单上传。
在结果中读取验证方法
决策与 Webhook
在会话决策和status.updated Webhook 的 decision 对象中,每个银行验证步骤都是 bank_verifications[] 的一个元素。其 method 说明了该账户是如何完成验证的:
在评估账户之前,
method 为 null;当用户在评估任何尝试之前选择不使用银行继续时,其值为 none:参见在结果中读取。请读取 method,而非 ownership.method,来区分不同的验证方法:ownership.method 是产生评分的姓名比对方式,例如 exact 或 fuzzy。
SessionDecision 模式中找到。
工作流规则
分支和自定义状态规则将读取与bank.method 相同的值,在规则构建器中标记为 Bank Verification Method,其取值为 Bank Sign-in、Account Check、Micro-deposits、Statement Upload 和 Continued Without a Bank。规则会比对该方法的值,例如在 AML 筛查步骤之后的一个分支,将具有高风险评分的账户核验发送去审核:
会话报告
会话 PDF 报告会在其 验证方法 这一行标明具体的方法。在引入验证方法之前保存的节点
bank_open_banking_enabled 和 bank_account_lookup_enabled 已停用。在 bank_method_order 存在之前保存的节点,现在按这两个开关原本给出的顺序运行:
如果此前在银行登录旁开启了账户核验,用户现在可以在银行选择器中将其作为备选方案看到(输入您的账户信息),而不仅限于其开户行发生故障时。两个开关均关闭的节点(此前仅提供小额打款或对账单上传)保持原样;后续保存时必须开启这两种方法中的至少一种。
在某一个过渡版本中,如果保存操作未发送
bank_method_order,但发送了任一开关,仍会根据开关设置顺序。每次保存都会反写这两个开关的值,分别表示是否有任何国家/地区提供银行登录,以及是否有任何国家/地区提供账户核验。在新的集成中,请使用 bank_method_order 和 bank_countries.<ISO3>.methods。
定价
每种方法均按其各自的价格收费,因国家/地区而异。请参见银行验证定价了解每个国家/地区的价格。- 银行登录拥有自身的价格,余额和交易附加组件各自分别计费。
- 账户核验按银行响应的每次核验计费一次:匹配、近似匹配、不匹配、无法核验的账户以及未找到的账户。按输入内容直接被拒的账户绝不收费。
在沙盒中测试
沙盒应用会在所有国家/地区按该步骤设置的顺序提供这两种方法,且不收取任何费用。在默认顺序下,用户首先进入银行登录,并可选择输入您的账户信息来运行账户核验。若要首先进入账户核验,请将bank_method_order 设置为 ["account_lookup", "open_banking"]。账户的最后四位字符将决定账户核验的响应结果:参见在沙盒中测试。
相关内容
- 账户核验:账户格式、结果及沙盒测试值。
- 当用户无法验证银行时:回退方案、“无需银行账户直接继续”及其结果。
- 账户核验 API:无需会话,直接从您的后端核验付款账户。
- 银行验证配置键:该步骤的所有配置键。
- 沙盒测试。