测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2290
功能说明:
- 支持簿记账户提现到银行卡、支付账户提现到银行卡;
- 簿记账户(簿记账户、应用营销账户、应用手续费账户)提现到银行账户:
- 支付账户提现到银行账户;
- 账户相关校验需要注意:
- 当薄记账户(会员状态=有效)、支付账户状态(账户状态=正常),签订账户提现协议且企业会员影印件OCR识别比对一致,则可提现。
- 个人会员支持提现到绑定的银行卡;
- 企业会员只支持提现至企业对公账户。如个体工商户需提现到法人银行卡,可通过【个人实名及绑卡申请】接口绑定法人银行卡,企业会员最多只允许绑定一张法人个人银行卡。
- 提现订单支付成功的条件为: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 |
是 |
业务返回说明 |