接口描述发起企业对公账号随机金额打款申请;打款进度以及交易流水号可通过查询随机金额打款进度接口查询获取。
注意:
1、沙箱环境下,在发起随机金额打款认证后,默认不会执行打款动作,开发者只需通过随机金额校验接口回填0.01元即可完成企业实名认证;正式环境下对公打款流程不变,回填金额需要在7日内完成。
2、对公打款申请次数超过次数上限,当日会被限制,隔天可以重新申请打款,无须获取新的flowid。金额回填校验失败超过3次,实名认证流程变为失败,需要重新获取新的认证flowid。
打款到账时间以银行到账时间为准,到账时间1-3个工作日不等。
e签宝对公打款公司名称根据打款选择的银行通道不同有所区别,具体对公名称如下:
【网商银行通道】:账号:8888888548802022,账户名:杭州天谷信息科技有限公司,开户行:浙江网商银行
【平安银行通道】:账号:15000094971252,账户名:杭州天谷信息科技有限公司,开户行:平安银行杭州西湖支行
接口/v2/identity/auth/pub/organization/{flowId}/transferRandomAmount
请求方式PUT
请求头提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。
请求参数参数名称
类型
必选
参数位置
参数说明
flowId
string
是
path
认证流程ID
bank
string
是
body
对公账号开户行总行名称
province
string
是
body
对公账号开户行所在省份名称
city
string
是
body
对公账号开户行所在城市名称
subbranch
string
是
body
对公账号开户行支行名称全称
cardNo
string
是
body
银行卡号信息
cnapsCode
string
是
body
联行号(名词解释) 可通过 【查询打款银行信息】接口获取,或第三方数据库获取
contextId
string
否
body
业务方业务上下文id,如果不填则取发起实名时的contextId
notifyUrl
string
否
body
打款成功后接收异步通知地址
响应参数参数名称
参数类型
必选
参数说明
code
int32
是
业务码,0表示成功,非0表示异常。
message
string
否
业务信息
请根据 code 来判断错误情况,不应该依赖 message 匹配,因为 message 可能会调整。
请求示例 {
"province": "浙江",
"subbranch": "xx银行杭州高新支行",
"bank": "xx银行",
"city": "杭州市",
"cnapsCode": "307***2584",
"cardNo": "110034**75702",
"contextId": "f0a7927dxxxx1130d86c8fa8",
"notifyUrl": "http://172.xx.xx.10:8080/testnotify/msgRecive"
}响应示例 {
"code": 0,
"message": "成功”
}错误码错误码
错误描述
解决方案
1203043
打款失败
请核实入参格式是否正确,并重新发起打款请求
30500000
操作出错,请联系服务人员处理, ID:XXXX
请核实入参格式是否正确
30500001
认证失败:XXXX
请核实入参格式是否正确
30500002
认证流程已结束
请重新发起认证流程
30500003
认证流程已失效,请重新发起认证
请重新发起认证流程
30500004
认证流程不存在
请核实当前流程id是否正确
30500050
认证业务不存在:XXXX
请核实当前流程id是否真实存在
30500052
该方式认证次数已达今日上限,请明日再试
当前认证次数超过上限,请联系e签宝相关工作人员核实
30500053
今日剩余XXXX次核验机会,请优先确认信息正确性
请核实入参信息是否正确
30500100
缺少参数:XXXX
请核实参数是否传入正确
30500101
参数错误:XXXX
请核实参数是否传入正确
30500116
格式校验不通过,请检查填入信息是否有多余空格
请核实入参是否存在空格
30502016
打款失败
请核实入参格式是否正确,并重新发起打款请求
30503107
很抱歉,订单余额不足
请核实是否有购买认证服务套餐,或登录e签宝官网核实账单记录