【反向打款认证】发起反向打款

更新时间:2025-04-10 19:32:19

接口描述

通过接口获取e签宝收款方的银行账户信息以及发起反向打款流程,企业通过银行向收款账号发起打款,打款后通过查询反向打款进度接口查询打款进度和交易流水号。

注意:

  1. 打款金额:0.01元(1分钱),请确保打款金额正确,如非1分钱则无法完成认证。
  2. 汇款金额作为企业实名专用,不做退还,无法开发票
  3. 汇款方必须使用对公账户进行汇款

请求地址

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

请求方式

POST

请求头

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

方式一:请求签名鉴权(优先推荐)

参数名称

类型

必选

参数说明

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,通过企业3要素或者4要素信息校验接口获取

authLetterFileId

string

Body

对公打款授权书文件ID(只支持PDF和图片格式)

  • 当appId开启展示数字证书服务协议后该字段必传
  • 需要先根据flowid调用《下载打款认证授权书填充后模板》接口获取授权书文件,认证企业进行线下盖公章后再上传至e签宝(通过文件上传接口:《文件上传》),供e签宝进行审核,授权书审核通过后本次认证才能认证通过。

Postman请求示例响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "mainAccountName": "杭州天谷信息科技有限公司",
        "subAccountNo": "30206857010042",
        "mainAccountBank": "平安银行杭州西湖支行",
        "paymentAmount": "0.01"
    }
}

响应参数

展开全部参数参数名称(点击左侧“+”一键展开)

类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

错误信息

请根据 code 来判断错误情况,不应该依赖message匹配,因为message 可能会调整。

data

object

业务信息




mainAccountName

string

收款方银行账户名称

subAccountNo

string

收款方银行账号,流程id变更时,将分配新的收款方银行账号

mainAccountBank

string

收款方开户行名称(支行名称)

paymentAmount

string

固定打款金额(0.01元)

错误码

错误码

错误描述

解决方案

30500000

操作出错,请联系服务人员处理, ID:XXXX

请核实入参格式是否正确

30500002

认证流程已结束

请重新发起认证流程

30500003

认证流程已失效,请重新发起认证

请重新发起认证流程

30500004

认证流程不存在

请核实当前流程id是否正确


我要纠错