3.4【提现申请】


测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle

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

接口代码(transCode):2290

功能说明:

  • 支持簿记账户提现到银行卡、支付账户提现到银行卡;
  1. 簿记账户(簿记账户、应用营销账户、应用手续费账户)提现到银行账户:
  2. 支付账户提现到银行账户;
  • 账户相关校验需要注意:
  1. 当薄记账户(会员状态=有效)、支付账户状态(账户状态=正常),签订账户提现协议且企业会员影印件OCR识别比对一致,则可提现。
  2. 个人会员支持提现到绑定的银行卡;
  3. 企业会员只支持提现至企业对公账户。如个体工商户需提现到法人银行卡,可通过【个人实名及绑卡申请】接口绑定法人银行卡,企业会员最多只允许绑定一张法人个人银行卡。
  4. 提现订单支付成功的条件为:status = OK且payStatus = success
  • 订单类型及订单子类型说明:

1.簿记账户提现到银行卡:订单类型“提现”,对应订单子类型“簿记账户提现”;

2.支付账户提现至银行账户:订单类型“提现”,对应订单子类型“支付账户提现”;

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

signNum

String

60

商户会员编号

支持个人会员、企业会员、平台。

若平台,上送固定值:#yunBizUserId_B2C#

reqTraceNum

String

50

商户订单号

全局唯一,不可重复

不可包含“|”字符

acctType

String

1

提现账户类型

1: 簿记账户(默认)

2:支付账户

payAcctNo

String

15

支付账户号

提现账户类型为 支付账户时必填

orderAmount

Long

20

订单金额

单位:分

couponAmount

Long

20

平台抽佣金额

内扣。

单位:分。

如订单金额为100,平台抽佣金额为2,实际到账金额为98,平台收入为2

respUrl

String

256

后台通知地址

 

payMode

JSONObject

256

支付模式

如不传,则默认为收付通代付

提现账户为1时,支持上送“自主出金”的支付模式

详情

receiveAcctType

String

1

入账账户类型

1:银行账户

acctNum

String

32

银行卡号

“入账账户类型”为“1:银行账户”时,需上送会员绑定的“银行卡号”;

withdrawType

String

2

提现方式

D0:D+0到账

注:目前仅支持“D0”

summary

String

100

摘要

不可包含“|”及换行符+,空格,/,?,%,#,&,=等特殊字符,最多50个字符

extendParams

String

200

扩展信息

原样返回

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

result

String

1

订单状态

订单成功时会发订单结果通知商户。

详情

respTraceNum

String

40

通联订单号

 

reqTraceNum

String

50

商户订单号(支付订单)

 

chnlTradeCode

String

50

收付通渠道银行流水号

 

extendParams

String

200

扩展信息

 

respCode

String

5

业务返回码

00000:代表成功

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

其他返回码:均代表失败

respMsg

String

200

业务返回说明

 

maxy2 2025年3月21日 11:15 收藏文档