测试地址:http://116.228.64.55:28082/yst-service-api/tx/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tx/handle
接口代码(transCode):2096
功能说明
- 该接口用于平台储值卡账户充值、平台/会员的簿记账户充值、支付账户商委充值;
- 该接口不支持分账;
- 平台/会员的簿记账户充值,当资金管理模式为“自主管理”、“银行管理”时支持发起,需特殊开通权限;
-
平台/会员簿记账户充值,针对receiverSignNum充值会员,默认风控参数为:单日3笔,单笔1000,日累计1000,月累计1000元。
- 新增支付模式:支付账户商委充值BIZCOMM_DEPOSIT。
- 新增支付模式:自主入金。
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
receiverSignNum |
String |
60 |
是 |
充值会员编号 |
商户系统用户唯一标识 平台储值卡账户/平台簿记账户收款时,固定上送“#yunBizUserId_B2C# ” |
platAcctType |
String |
2 |
否 |
账户类型 |
当receiverSignNum为“#yunBizUserId_B2C#”时必填 00:支付账户(平台会员和普通会员都上送) 01:簿记账户 09:应用储值卡账户:(非“账后结算”资金管理模式) 10:储值卡待结算户(“账后结算”资金管理模式) |
signNum |
String |
60 |
否 |
付款人会员编号 |
商户系统用户唯一标识 平台储值卡账户/平台簿记账户收款且银行卡协议支付时使用,银行卡协议支付:付款会员需先注册 会员簿记账户充值时,无需上送 |
reqTraceNum |
String |
50 |
是 |
商户订单号 |
|
orderAmount |
Long |
20 |
是 |
订单金额 |
单位:分 订单金额=支付金额+营销金额 |
payAmount |
Long |
20 |
否 |
支付金额 |
单位:分 渠道实际需支付金额 不上送时,则“营销金额”必送,即:订单金额=营销金额; 订单金额=支付金额(在支付账户商委充值支付模式下) |
promotionAmount |
Long |
20 |
否 |
营销金额 |
单位:分 平台承担的营销金额 |
couponAmount |
Long |
20 |
否 |
抽佣金额 |
单位:分 |
payMode |
JSONObject |
256 |
否 |
支付模式 |
详见支付模式字典 注“支付金额”为空或0时,可不送 除“余额支付:BALANCE_PAY”外,支持其他所有的入金类支付模式 新增支付模式: 支付账户商委充值:BIZCOMM_DEPOSIT 新增支付模式: “自主入金” (注:“自主入金”仅支持资金管理模式为:通联管理、银行管理、自主管理)
|
reqsUrl |
String |
256 |
否 |
前台通知地址 |
|
respUrl |
String |
256 |
是 |
后台通知地址 |
|
orderValidTime |
String |
20 |
否 |
订单过期时间 |
格式:yyyy-MM-dd HH:mm:ss |
goodsName |
String |
50 |
否 |
商品名称 |
如下支付模式必填: 1.快捷支付 2.H5收银台 3.微信小程序收银台 4.支付宝小程序收银台 |
goodsDesc |
String |
256 |
否 |
商品描述 |
|
summary |
String |
100 |
否 |
摘要 |
|
extendParams |
String |
200 |
否 |
扩展参数 |
接口将原样返回,不可包含“|”特殊字符 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
result |
String |
1 |
否 |
订单状态 |
仅交易验证方式为“0”时返回 订单成功时会发订单结果通知商户。 |
respTraceNum |
String |
40 |
是 |
通联订单号 |
|
reqTraceNum |
String |
50 |
是 |
商户订单号 |
|
extendParams |
String |
200 |
否 |
扩展参数 |
|
channelParamInfo |
JSONObject |
|
否 |
渠道参数信息(支付详情) |
渠道返回时有值 |
chnlFrontParamInfo |
JSONObject |
|
否 |
渠道参数信息(前端支付参数) |
渠道返回时有值 (1)扫码支付信息/ JS支付串信息(微信、支付宝、QQ钱包) (2)交易验证方式(收银宝快捷) (3)收银宝小程序收银台支付参数(innappid) (4)收银宝手机安全控件支付参数(innappid) |
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
业务返回说明 |
|
isPreConsume |
String |
40 |
否 |
是否微信订单预消费 |
目前仅支持在订单子支付模式为微信订单预消费时返回 枚举值: 0:否 1:是 |