4.1【银行子账户提现申请】接口


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle

接口代码(transCode):2292

功能说明:支持银行子账户提现至鉴权绑定的账户。

华通银行:

(1)客户向银行申请开通“显示付款账户”功能,对于走人行大小额出款的,可以支持上送显示付款账号和显示付款户名;若上送,则电子回单付款方就是开立的记账簿账号和户名;不上送,付款方就是华通开的xxx资金专用户;

平台入驻商户提现限额受到平台客户号单日限额和平台下记账簿账户单日限额/对私单笔限额/对公单笔限额控制,需在商务环节确认好各项限额。

(2)华通银行支持个人会员、企业会员提现。不支持平台抽佣。

(3)银行对手续费收取是轧差还是收支两条线都可以支持配置,对于通联商户来说都是收支分开的,手续费是银行直接和通联签署,银行不支持和客户签署手续费。

中信银行:

(1)支持个人、企业、平台提现。不支持平台抽佣。

(2)平台提现:平台提取“平台保证金”登记簿内资金,提现手续费承担方式=“1-平台承担”。

 

业务请求参数

字段

字段类型

必填

字段名称

说明

signNum

String

是

商户会员编号

支持平台提现,上送#yunBizUserId_B2C#

中信银行支持平台提现

民生银行,支持平台提现

subAcctNo

String

否

银行子账号

中信平台提现,非必填

民生银行,平台/会员提现,必填

reqTraceNum

String

是

商户订单号

全局唯一,不可重复

不可包含“|”字符

tradeAmount

Long

是

订单金额

单位:分

respUrl

String

否

后台通知地址

 

payMode

String

是

支付模式

固定:WITHDRAW_BANK

acctNum

String

是

银行卡号

民生银行,会员子账户提现,必填

中信银行、华通银行,必填

showPayerAcctNo

String

否

显示付款账号

华通银行支持上送,必须为发起交易的记账簿账户号码,否则交易失败

showPayerAcctName

String

否

显示付款户名

华通银行支持上送,必须为发起交易的记账簿账户户名,否则交易失败

acctName

String

否

账户名

中信银行:

【银行卡管理】菜单存在此银行卡号,则上送则需与已绑定的银行卡账户名一致;

【银行卡管理】菜单不存在此银行卡号,则必须上送;

华通银行:无需上送(上送,则校验)

 民生银行:无需上送(上送错误不校验)

 

summary

String

否

摘要

中信银行,华通银行、民生银行透传银行侧“备注”字段

extendParams

String

否

扩展信息

原样返回

业务响应参数

字段

字段类型

必填

字段名称

说明

result

String

否

订单状态

 

respTraceNum

String

是

通联订单号

 

reqTraceNum

String

是

商户订单号(支付订单)

 

chnlTradeCode

String

否

银行交易流水号

透传“中信银行流水号”

extendParams

String

否

扩展信息

 

respCode

String

是

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg

String

是

业务返回说明

 

2026年7月3日 10:51 收藏文档