【打款认证】发起随机金额打款

更新时间：2023-10-25 18:11:16

接口描述

发起企业对公账号随机金额打款申请；打款进度以及交易流水号可通过查询随机金额打款进度接口查询获取。

注意：

1、正式环境的打款银行那边是不会有短信通知的，需要自行查看银行流水；测试环境可告知公司名称，提供给交付顾问查询

2、沙箱环境下，在发起随机金额打款认证后，默认不会执行打款动作，开发者只需通过随机金额校验接口回填0.01元即可完成企业实名认证；正式环境下对公打款流程不变。

3、对公打款申请次数超过次数上限，当日会被限制，隔天可以重新申请打款，无须获取新的flowid。金额回填校验失败超过3次，实名认证流程变为失败，需要重新获取新的认证flowid。

打款到账时间以银行到账时间为准，到账时间1-3个工作日不等。

e签宝对公打款公司名称根据打款选择的银行通道不同有所区别，具体对公名称如下：

【网商银行通道】：账号：8888888548802022，账户名：杭州天谷信息科技有限公司，开户行：浙江网商银行

【招商银行通道】：账号：571904343210803，账户名：杭州天谷信息科技有限公司，开户行：招商银行杭州解放分行

【平安银行通道】：账号：15000094971252，账户名：杭州天谷信息科技有限公司，开户行：平安银行杭州西湖支行

当传入mobile字段用于接收网商银行打款通知，短信通知模板内容，如下所示：

打款成功：

<业务说明>，网商银行已给尾号为<4位尾号>的账户汇入了一笔小额验证资金，请登录该账户网银查询，并登录<平台名称>进行到账金额确认。

打款失败：

<业务说明>，网商银行向您尾号为<4位尾号>的账户转账失败，请登录<平台名称>确认您绑定的账户是否正确。

接口

/v2/identity/auth/pub/organization/{flowId}/transferRandomAmount

请求方式

PUT

请求头

提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	应用ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	否	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值：Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情。

请求参数

参数名称	类型	必选	参数位置	参数说明
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	打款成功后接收异步通知地址
mobile	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签宝官网核实账单记录