合单支付-订单明细查询

1、修订记录

修订记录	日期	说明
1.0	2023.02.22	初版

2、业务说明

（1）接口说明

需要查询合单交易订单及明细状态，调用此接⼝

请求主体类型：application/json

请求方式：POST

3、请求地址

环境	HTTPS请求地址
测试环境	https://appdev.ysepay.com/openapi/unify/online/trade/order/queryCombine
正式环境	https://ysgate.ysepay.com/openapi/unify/online/trade/order/queryCombine

4、请求参数说明

4.1、公共请求参数

参数	类型(长度）	必填	参数说明
timeStamp	String	Y	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"
method	String(128)	Y	接口名称，固定值：unify.online.trade.order.queryCombine
charset	String(10)	Y	请求使用的编码格式，如utf-8,gbk,gb2312等,固定为utf-8
sign	String	Y	商户请求参数的签名串（签名算法默认为国密）,详见demo,注意:请用商户私钥进行签名
check	String	Y	银盛公钥加密随机生成的字符串（key）得到的加密值，详见demo
bizContent	String	Y	业务参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递。注意：需要通过AES以及随机生成的字符串（key）加密业务参数集合，得到bizContent
reqId	String	Y	请求唯一流水号,商户系统唯一，要求32个字符内（最少14个字符），只能是数字、大小写字母_-且在同一个商户号下唯一。最后12位要求格式为"yyMMddHHmmss" 示例值：xy1415220315145602
certId	String	Y	发起方商户号，服务商在银盛给自己开设的商户号，即可当作发起方商户号，由银盛生成并下发。注意：不同于子商户号，服务商发展的商户即为子商户号
version	String	Y	调用的接口版本，固定为：1.0

4.2、业务请求参数

（bizContent加密前的json数据明文字符串）

参数	类型(长度）	必填	参数说明
combineOrderId	String(32)	N	商户订单号,商户生成的合单订单号（订单号、交易流水号不能同时为空，二选一）。示例值：201805256843192280647118。
combineTradeSn	String(32)	N	交易流水号,该交易在银盛支付系统中的交易流水号。（订单号、交易流水号不能同时为空，二选一）。

5、响应参数说明

请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。

5.1、公共响应参数

参数	类型(长度）	必填	参数说明
code	String(5)	Y	网关响应码，示例值：00000 ，详见网关公共响应码
msg	String(50)	Y	网关响应码描述
subCode	String	Y	业务响应码，参见具体的API接口文档
subMsg	String	Y	业务响应描述
timeStamp	String	Y	响应时间，格式"yyyy-MM-dd HH:mm:ss"
norce	String(128)	Y	随机参数
sign	String	Y	响应参数的签名串，详见demo, 注意:请用银盛公钥进行验签
businessData	String	Y	业务响应参数集合，注意：银盛网关通过AES加密业务响应参数集合，得到businessData，商户需要对其进行解密，详情请见demo

5.2、业务响应参数

响应业务参数businessData(json数据)

参数	类型(长度）	必填	参数说明
reqMsgId	String	N	请求流水号,同⼊参请求流水号
businessData	Object	N	响应数据

5.2.1 businessData具体参数

参数	类型(长度）	必填	参数说明
combineOrderId	String	N	商户生成的合单订单号
combineTradeSn	String	N	银盛支付合单交易流水号
totalAmount	String	N	订单的资金总额,单位：分。
tradeStatus	String	N	交易目前所处的状态,状态如下： 00-交易成功 02-支付成功,合单交易渠道成功但参与营销，需人工调账待支付 11-支付中（已向渠道跳转） 12-部分支付 13-全部已支付(担保交易使用)等待发货 14-未确认收货（等待付款方确认） 60-提现登记 61-提现完成 70-自动关闭处理中 80-部分退款 81-全部退款 97-客户主动关闭 99-到时关闭' 01-支付成功 98-支付失败 96-交易失败（超金额支付） 50-业务超时 95-关闭订单 94-无支付订 93-订单撤销
orderList	Array	N	订单列表

5.2.1.1 orderList具体参数

参数	类型(长度）	必填	参数说明
tradeStatus	String	N	银盛支付交易流水号,状态如下： 00-交易成功 02-支付成功,合单交易渠道成功但参与营销，需人工调账待支付 11-支付中（已向渠道跳转） 12-部分支付 13-全部已支付(担保交易使用)等待发货 14-未确认收货（等待付款方确认） 60-提现登记 61-提现完成 70-自动关闭处理中 80-部分退款 81-全部退款 97-客户主动关闭 99-到时关闭' 01-支付成功 98-支付失败 96-交易失败（超金额支付） 50-业务超时 95-关闭订单 94-无支付订 93-订单撤销
tradeSn	String	N	银盛支付交易流水号
orderId	String	N	商户生成的订单号
amount	String	N	金额,单位：分。
accountDate	String	N	入账日期,格式”yyyy-MM-dd” ，示例值：2014-07-24。
settlementAmount	String	N	结算金额,单位：分。
discountAmount	String	N	优惠金额,单位：分。
payDetailList	Array	N	子单支付明细信息

5.2.1.1.1 payDetailList具体参数

参数	类型(长度）	必填	参数说明
status	String	N	支付状态,状态如下： 00-交易成功 02-支付成功,合单交易渠道成功但参与营销，需人工调账待支付 11-支付中（已向渠道跳转） 12-部分支付 13-全部已支付(担保交易使用)等待发货 14-未确认收货（等待付款方确认） 60-提现登记 61-提现完成 70-自动关闭处理中 80-部分退款 81-全部退款 97-客户主动关闭 99-到时关闭' 01-支付成功 98-支付失败 96-交易失败（超金额支付） 50-业务超时 95-关闭订单 94-无支付订 93-订单撤销
sendChannelTime	String	N	发往渠道时间,格式”yyyy-MM-dd HH:mm:ss”，示例值：2019-5-24 09:44:31。
serialNumber	String	N	序列号,序列号数值越大则表示此笔交易流水为最新记录。
partnerFee	String	N	该笔订单的合作方手续费(参考),单位：分。
payeeFee	String	N	该笔订单的收款方手续费(参考),单位：分。
channelSendSn	String	N	发往渠道流水
channelRecvSn	String	N	渠道返回流水
bankType	String	N	二维码行别,行别如下：微信-1902000 支付宝-1903000 QQ扫码-1904000 银联扫码-9001002 招商银行 -3085840
totalDiscountFee	String	N	优惠手续费,单位：分。
isDiscount	String	N	是否参与优惠,Y-是；N-否。

6、业务响应码网关公共响应码

响应码	响应码描述	解决方案
0000	成功	成功后，根据businessData里面的业务参数进行业务处理。
9999	失败	查看失败原因，重新发起查询。
5000	交易超时	重新发起查询。
A029998	网关非法参数	检查请求参数，修改后重新发起请求
B021100	前置系统参数验证错误	检查请求参数，修改后重新发起请求
B043001	查询结果为空	原订单交易不存在
B043003	商户号有误	请检查发起方商户号/收款方商户号是否真实存在
B049901	业务失败	参看具体错误描述
B089900	找不到原交易

results matching ""

No results matching ""