合单支付-支付宝生活号下单

1、修订记录

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

2、业务说明

(1)接口说明

场景说明:
在电商场景中需要多个商户或一个商户多个商户添加至购物车内,支持合单支付,即用户提交一笔订单中包含多个子商户订单信息,用户确认无误后一笔支付订单总金,合单支付款项分别进入子商户各自的账户。
注意事项:
1、商户调用此接口前,请确保已开通“生活号第三方应用“。
2、代创建提交且支付宝审核通过后,下一步则需商户做代创建的授权确认,商户可登录商家中心b.alipay.com查看待办事项,并确认授权。

请求主体类型:application/json

请求方式:POST

3、请求地址

环境 HTTPS请求地址
测试环境 https://appdev.ysepay.com/openapi/unify/aliPay/jsCombine
正式环境 https://ysgate.ysepay.com/openapi/unify/aliPay/jsCombine

4、请求参数说明

4.1、公共请求参数

参数 类型(长度) 必填 参数说明
timeStamp String Y 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss"
method String(128) Y 接口名称,固定值:unify.aliPay.jsCombine
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数据明文字符串)

参数 类型(长度) 必填 参数说明
orderId String(32) Y 订单号,商户系统生成的订单号,要求如下:
1、须保证在商户端不重复。
2、只能由大小写英文字母、数字、下划线及横杠组成。
建议前8位为交易日期,如20220525,范围跨度支持包含当天在内的前后一天,示例值:202205256843192280647118
shopDate String(8) Y 交易日期,商户系统的交易发生日期格式yyyyMMdd, 示例值:20180525
timeOutExpress String(6) Y 交易超时时间,设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。(需申请业务权限,权限未开通情况下该参数不生效,默认未付款交易的超时时间为7d)取值范围:1m~15d。m-分钟,h-小时,d-天。该参数数值不接受小数点,如1.5h,可转换为90m。注意:设置了未付款交易超时时间的情况下,若我司在限定时间内没有收到成功支付通知,则会关闭交易,关闭后该笔交易若付款方支付成功的情况下,会自动原路退款至付款方。示例值:96h 代表96小时后订单自动关闭
buyerLogonId String(100) N 买家支付宝账号,和buger_id不能同时为空。该字段于2023-9-1已不支持使用,请使用buyerId对接,如有疑问请咨询银盛技术支持!
buyerId String(100) N 买家支付宝用户ID,和buyer_logon_id不能同时为空。buyer_id获取方法:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.8ujLD6&treeId=115&articleId=104114&docType=1通过网页授权获取用户信息,同步响应结果中的user_id对应文档中的buyer_id。
combineMercId String(20) Y 合单交易商户号,合单交易银盛支付商户号,必须是子单收款商户号或者服务商商户号.
busiCode String(100) Y 业务代码
note String(125) Y 商品的标题,商品的标题/交易标题/订单标题/订单关键字等。该参数最长为250个汉字。
amount String(10) Y 订单总金额,该笔子订单的资金总额,单位:分。必须为正整数。
currency String(3) N 支持币种,支持币种:CNY(人民币),默认CNY。
extraCommonParam String(1000) N 公用回传参数,公用回传参数 商户自定义数据域,原样返回。
notifyUrl String(190) Y 异步通知地址,交易成功异步通知到商户的后台地址。
srcIP String(16) Y 发起方IP
payerIP String(16) N 付款方IP
orderList Array Y 子单订单信息,最多50笔。

4.2.1 orderList具体参数

参数 类型(长度) 必填 参数说明
inOrderId String(32) Y 子订单号,商户系统生成的订单号,要求如下:
1、须保证在商户端不重复。
2、只能由大小写英文字母、数字、下划线及横杠组成。
建议前8位为交易日期,如20220525,范围跨度支持包含当天在内的前后一天,示例值:202205256843192280647118
inAmount String(10) Y 子订单金额,该笔子订单的资金总额,单位:元。必须为正整数。
inPayeeMercId String(200) Y 收款方商户号,银盛支付子单收款商户号。

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 Y 请求流水号,同⼊参请求流水号
systemCode String N 系统编码
businessData Object Y 响应结果对象

5.2.1 businessData具体参数

参数 类型(长度) 必填 参数说明
orderId String N 商户订单号
tradeSn 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-订单撤销
amount String N 订单金额,单位:分。
currency String N 交易币种
extraCommonParam String N 公共回传参数
jsapiPayInfo Object N 支付宝返回参数,JSON字符串。

5.2.1.1 jsapiPayInfo具体参数

参数 类型(长度) 必填 参数说明
tradeNO String(32) Y 交易流水
status String(32) Y 状态

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

响应码 响应码描述 解决方案
0000 交易成功
9999 失败
5000 交易超时
A029998 网关非法参数 检查请求参数,修改后重新发起请求。
B020100 前置无提供者 检查请求参数,修改后重新发起请求。
B021100 前置系统参数验证错误 检查请求参数,修改后重新发起请求。
B022011 发起方商户号和商户号的归属关系校验失败 检查发起方商户号和商户号的归属关系。
B023006 订单重复支付 检查订单号是否重复,重新生成订单号。
B029901 业务失败 根据实际返回消息分析具体原因。

results matching ""

    No results matching ""