接口描述
校验银行四要素短信验证码
接口
/v2/identity/auth/pub/individual/{flowId}/bankCard4Factors
请求方式
PUT
请求头
提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。
请求参数
参数名称 | 类型类型 | 必选 | 参数位置 | 参数说明 |
flowId | string | 是 | path | 认证流程ID |
authcode | string | 是 | body | 短信验证码,用户收到的6位数字验证码 |
响应参数
参数名称 | 类型 | 必选 | 参数说明 |
code | int32 | 是 | 业务码,0表示成功,非0表示异常。 |
message | string | 是 | 错误信息 请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。 |
请求示例
{
"authcode": "123456"
}
响应示例
{
"code": 0,
"message": "成功”
}
错误码
错误码 | 错误描述 | 解决方案 |
30500002 | 认证流程已结束 | 请核实当前认证流程是否已经认证完成 |
30500003 | 认证流程已失效,请重新发起认证 | 认证流程超过30天会自动失效,需重新发起认证流程 |
30500004 | 认证流程不存在 | 请核实传入的flowId是否真实存在 |
30500101 | 参数错误:短信验证码不能为空 | 请核实验证码是否为空 |
30501004 | 请先完成银行卡四要素信息核验 | 当前流程并不是通过银行卡四要素认证接口返回,请核实或通过银行卡四要素认证接口发起认证流程 |
30503002 | 验证码校验失败 | 请核实验证码是否真实有效 |
30503004 | 验证码校验失败,已达到最大次数限制 | 验证次数超过上限,请重新发起运营商三要素认证流程 |
30503006 | 短信验证码已过时效性,请重新发送 | 验证码超过15分钟已失效,请重新发起运营商三要素认证流程 |
30500116 | 格式校验不通过,请检查填入信息是否有多余空格 | 请核实入参是否存在空格 |