2.2基础能力服务

商户账户余额查询

生产地址：https://vsp.allinpay.com/apiweb/cusacct/querybalance

测试地址：https://syb-test.allinpay.com/apiweb/cusacct/querybalance

使用场景：

查询商户账户余额

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	平台分配的机构号	是	15	单商户查询，orgid为空
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
accttype	查询类型	1.余额户查询	否	2	暂只支持01
signtype	签名类型		否	8	RSA SM2
sign	签名	详见安全规范	否	32

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	retcode=SUCCESS情况下，表示查询成功，交易状态按照trxstatus判断；retcode=FAIL表示接口拒绝交易，如验签失败/数据格式错误/数据字段缺失。
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
amount	账户金额	单位:分	否	15
randomstr	随机字符串	随机生成的字符串	是	32
sign	签名		否	32	详见安全规范

商户账户余额结算

接口地址：https://vsp.allinpay.com/apiweb/cusacct/withdraw

使用场景：

发起针对cusid的资金结算的请求，支持立即结算及T+1日标准结算.立即结算状态trxstatus如为2000，则需要调商户账户余额结算查询接口查询是否成功（支持时间段6-23点）

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	平台分配的机构号	是	15	单商户标准结算，orgid为空
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8	如orgid不为空，则对应orgid获取到的appid
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
trxamt	结算金额		否	Number	单位：分
reqsn	请求流水号		否	32
deptype	结算类型	1：快速结算 2：标准结算	否	2
remark			是	100	结算备注
summary	摘要	银行摘要	是	64
signtype	签名类型		是	8	RSA/SM2
sign	签名	详见安全规范	否	32

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	retcode=SUCCESS情况下，表示查询成功，交易状态按照trxstatus判断；retcode=FAIL表示接口拒绝交易，如验签失败/数据格式错误/数据字段缺失。
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
randomstr	随机字符串	随机生成的字符串	是	32
trxamt	实际结算到账金额	单位:分	否	number
fee	结算手续费	单位：分	否	number
trxid	通联单号		否	18
reqsn	请求流水号		否	32
trxstatus	结算状态		否	4	0000/4000为成功 2000为处理中
errmsg	交易描述信息		是	64
sign	签名		否	32	详见安全规范

商户账户余额结算查询

接口地址：https://vsp.allinpay.com/apiweb/tranx/query

使用场景：

查询4.2发起针对cusid的资金结算的请求的状态及详情

请求参数：

参数	参数名称	取值	可空	最大长度	备注
orgid	机构号	平台分配的机构号	是	15
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8	如orgid不为空，则对应orgid获取到的appid
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
trxid	通联单号		可	18	trxid与reqsn不可同时为空。建议优先使用trxid查询
reqsn	请求流水号		可	32
signtype	签名类型		否	8	RSA/SM2
sign	签名	详见安全规范	否	32

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	retcode=SUCCESS情况下，表示查询成功，交易状态按照trxstatus判断；retcode=FAIL表示接口拒绝交易，如验签失败/数据格式错误/数据字段缺失。
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的APPID	否	8
randomstr	随机字符串	随机生成的字符串	是	32
trxcode	交易类型		否	6	结算：300003
chnltrxid	渠道流水号		是	64
initamt	发起结算金额	单位：分	否	Number
trxamt	实际结算到账金额	单位:分	否	number
fee	结算手续费	单位：分	否	number
trxid	通联单号		否	18
reqsn	请求流水号		否	32
trxstatus	结算状态		否	4
fintime	结算完成时间	yyyyMMddHHmmss	否
acct	结算到账账号		否	64
errmsg	交易描述信息		是	64
accttype	借贷标识		是	2	00-借记卡 02-信用卡 99-其他（花呗/余额等）
bankcode	所属银行		是
feecycle	结算周期		是	2	1预收 2日结 4月结 8向持卡人收
sign	签名		否	32	详见安全规范

商户账户历史余额查询

接口地址

生产环境：https://vsp.allinpay.com/cusapi/cusacct/queryhisbalance
测试环境：http://syb-test.allinpay.com/vsppcusapi/cusacct/queryhisbalance

使用场景：
查询商户历史余额

请求参数：

参数	参数名称	取值	是否为空	最大长度	备注
orgid	机构号	平台分配的机构号	否	15
cusid	商户号	平台分配的商户号	否	15
appid	应用ID	平台分配的机构APPID	否	8
version	版本号	接口版本号	是	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
sign	签名	详见安全规范	否	32
signtype	签名方式	SM2/RSA	否	4
acctdate	日期	历史日期	否	8	YYYYMMDD

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非交易结果
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
errmsg	错误信息		是	100
sign	签名		否	32	详见安全规范
amount	历史金额	单位分

充值入账结果通知

注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用request.getparam(“key”)这样用文档中的字段名来一个个获取,到时候收银宝增加通知字段,就无法兼容了.请参考demo

通知的每一个字段都会进行UTF-8的UrlEncode,如果商户接收结果的服务器用web容器进行接收,例如TOMCAT,IIS.则无需进行URLDecode,如果不是用web容器进行接收,而是读数据流自己进行解析,则需要进行UTF-8的UrlDecode

以java为例:
String trxreserve = "订购人+10086";
String sendData = URLEncoder.encode(trxreserve, "UTF-8");
String getData = URLDecoder.decode(sendData, "UTF-8");

通知响应结果：
商户服务端在接收到结果通知并正确处理后，应响应消息。正确处理响应success，其他响应或者不响应通联开发平台则通过重发机制进行重发，重发次数为5次

对后台通知交互时，如果通联收到商户的应答不符合规范或超时，通联认为通知失败，通联会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但通联不保证通知最终能成功。（通知频率为15s/15s/5m/10m/15m - 总计30m30s）

请求参数如下：

字段名称	类型	可空	说明	最长长度	备注
appid	string	否	收银宝APPID	8
outtrxid	string	否	第三方交易号	50	暂未启用
trxcode	string	否	交易类型	8	详见附录交易类型
trxid	string	否	收银宝交易单号	50	通联收银宝交易流水号
initamt	string	否	原始下单金额	20	与请求trxamt值一致
trxamt	long	否	交易金额	20	单位：分
trxdate	string	否	交易请求日期	8	yyyymmdd
paytime	string	否	交易完成时间	14	yyyymmddhhmmss
chnltrxid	string	可	渠道流水号	64	如支付宝，微信平台订单号
trxstatus	string	否	交易结果码	4	交易状态详见交易返回码说明
cusid	string	否	商户编号	15
termno	string	可	终端编号	20
termbatchid	string	可	终端批次号	16
termtraceno	string	可	终端流水号	6
termauthno	string	可	终端授权码	20
termrefnum	string	可	终端参考号	50
trxreserved	String	可	业务关联内容	160	交易备注
srctrxid	string	可	原交易流水	50	通联原交易流水，冲正撤销交易本字段不为空
cusorderid	string	否	业务流水	32	统一下单对应的reqsn订单号
acct	string	可	交易账号	64	如果是刷卡交易，则是隐藏的卡号，例如 621700******4586
fee	string	可	手续费	15	单位：分
signtype	string	可	签名类型	3	MD5/RSA/SM2。为空默认MD5
cmid	string	可	渠道子商户号	32	仅微信/支付宝交易有效
chnlid	string	可	渠道号	32	仅微信交易有效
chnldata	String	可	渠道信息	-	仅返回云闪付/微信/支付宝的渠道信息
accttype	String	可	借贷标识	2	00-借记卡 02-信用卡 99-其他（花呗/余额等）
bankcode	String	可	发卡行	20
logonid	String	可	支付宝买家账号	32
sign	String	否	sign校验码	32

备注：chnldata
云闪付示例：{"couponInfo":"[{\"id\":\"2112020052715193\",\"desc\":\"2020年银联62节-永旺超市蒙牛百利包单品营\",\"type\":\"CP01\",\"spnsrId\":\"00010000\",\"offstAmt\":\"1100\"},{\"id\":\"2112020052715193\",\"desc\":\"2020年银联62节-永旺超市蒙牛百利包单品营\",\"type\":\"CP01\",\"spnsrId\":\"82119105411XXXX\",\"offstAmt\":\"900\"}]"}
支付宝示例：{"voucher_detail_list":"[{\"amount\":\"0.20\",\"merchantContribute\":\"0.20\",\"name\":\"0.20元代金券\",\"otherContribute\":\"0.00\",\"type\":\"ALIPAY_BIZ_VOUCHER\",\"voucherId\":\"2020060400073002293805XTTADO\"}]","fund_bill_list":"[{\"amount\":\"0.80\",\"fundChannel\":\"ALIPAYACCOUNT\"},{\"amount\":\"0.20\",\"fundChannel\":\"MDISCOUNT\"}]"}
微信示例： {"promotion_detail":"[{\"amount\":100,\"merchant_contribute\":\"100\",\"other_contribute\":\"0\",\"promotion_id\":\"11605335223\",\"type\":\"DISCOUNT\",\"wxpay_contribute\":\"0\",\"scope\":\"GLOBAL\",\"activity_id\":\"10722272\",\"name\":\"返回优惠信息券\"}]"}

2.2基础能力服务

目录

商户账户余额查询

商户账户余额结算

商户账户余额结算查询

商户账户历史余额查询

充值入账结果通知