3.5 【充值申请】


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

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

接口代码(transCode):2096

功能说明

  1. 该接口用于平台储值卡账户充值、平台/会员的簿记账户充值、支付账户商委充值
  2. 该接口不支持分账;
  3. 平台/会员的簿记账户充值,当资金管理模式为“自主管理”、“银行管理”时支持发起,需特殊开通权限;
  4. 平台/会员簿记账户充值,针对receiverSignNum充值会员,默认风控参数为:单日3笔,单笔1000,日累计1000,月累计1000元。

  5. 新增支付模式:支付账户商委充值BIZCOMM_DEPOSIT。
  6. 新增支付模式:自主入金。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

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:是


liping2 2025年3月21日 11:22 收藏文档