b2c-docs/docs/wx/3.md

3. API接口

3.1. 消费交易接口

1. 请求报文格式

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	消费交易填写“PURC”
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	交易模式	10	文本	mode	"applet"
6	SDK 版本	10	文本	jssdk	"1.0"
7	授权码	60	文本	code	微信小程序 login 接口获得的授权码
8	订单金额	12	文本	orderAmount	如 100 元，表示为 100 或 100.00
9	订单币种	3	文本	orderCurrency	人民币填写“CNY”,美元填写"USD"
10	前端 URL 地址	400	文本	frontURL	支付结果前端通知到该地址
11	后端 URL 地址	400	文本	backURL	支付结果异步通知到该地址
12	商户预留字段	1024	文本	merReserve	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
13	商户代码	15	文本	merID	商户 ID，由AllPay 分配
14	收单行 ID	11	文本	acqID	收单行 ID "99020344"
15	支付渠道代码	10	文本	paymentSchema	"WX"
16	商品信息	60	文本	goodsInfo	商品信息
17	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
18	签名类型	3	文本	signType	MD5
19	签名	32	文本	signature	采用 MD5 签名

1. 返回数据格式

{
  'timeStamp': '',
  'nonceStr': '',
  'package': '',
  'signType': 'MD5',
  'paySign': ''
}

将上述返回数据放入微信小程序支付接口,即可调起微信小程序支付,具体方法,参考微信小程序 API

3.2. 异步通知报文

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	消费交易填写“PURC”
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	订单金额	12	文本	orderAmount	如 100 元，表示为 100 或 100.00
6	订单币种	3	文本	orderCurrency	人民币填写“CNY”,美元填写"USD"
7	清算金额	12	文本	settAmount	如 100 元，表示为 100 或 100.00
8	清算币种	3	文本	settCurrency	符合 ISO 标准，填写数字类型
9	清算汇率	7	文本	rate	实际汇率，7 位有效数字
10	商户预留字段	1024	文本	merReserve	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
11	GW 交易 ID	32	文本	transID	GW 系统生成的交易 ID，每笔交易保持唯一
12	商户代码	15	文本	merID	商户 ID，由AllPay 分配
13	收单行 ID	11	文本	acqID	收单行 ID "99020344"
14	支付渠道代码	10	文本	paymentSchema	渠道代码："WX
15	交易应答码	2	文本	RespCode	应答码 00-成功
16	应答文字信息	20	文本	RespMsg	应答消息，全部为英文字符
17	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
18	GW 处理时间	14	文本	GWTime	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
19	签名类型	3	文本	signType	MD5
20	签名	32	文本	signature	采用 MD5 签名

3.3. 查询交易接口

1. 接口说明

该接口为接入商家提供交易查询的功能。

1. 请求报文格式

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	查询填写“INQY”
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	商户预留字段	1024	文本	merReserve	商户保留
6	商户代码	15	文本	merID	商户 ID，由AllPay 分配
7	收单行 ID	11	文本	acqID	收单行 ID "99020344"
8	支付渠道代码	10	文本	paymentSchema	渠道代码："WX
9	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
10	签名类型	3	文本	signType	MD5
11	签名	32	文本	signature	采用 MD5 签名

1. 响应报文格式

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	查询交易填写为“INQY
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	GW 交易 ID	32	文本	transID	GW 系统生成的交易 ID，每笔交易保持唯一
6	商户代码	15	文本	merID	商户 ID，由AllPay 分配
7	收单行 ID	11	文本	acqID	收单行 ID "99020344"
8	交易应答码	2	文本	RespCode	应答码 00-成功
9	应答文字信息	20	文本	RespMsg	应答消息，全部为英文字符
10	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
11	GW 处理时间	14	文本	GWTime	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
12	签名类型	3	文本	signType	MD5
13	签名	32	文本	signature	采用 MD5 签名

3.4. 退款交易接口

1.接口功能说明

该接口为接入商家提供交易退款的功能。

2.请求报文格式

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	退款填写“REFD”
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	退款金额	12	文本	returnAmount	如 100 元，表示为 100 或 100.00
6	订单币种	3	文本	orderCurrency	人民币填写“CNY”,美元填写"USD"
7	商户预留字段	1024	文本	merReserve	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
8	商户代码	15	文本	merID	商户 ID，由AllPay 分配
9	收单行 ID	11	文本	acqID	收单行 ID "99020344"
10	支付渠道代码	10	文本	paymentSchema	渠道代码："WX
11	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
12	签名类型	3	文本	signType	MD5
13	签名	32	文本	signature	采用 MD5 签名

3.响应报文格式

序号	名称	长度	类型	参数名称	备注
1	版本号	12	文本	version	统一填写为“VER000000002”
2	字符集编码	6	文本	charSet	统一填写为“UTF-8”
3	交易类型	4	文本	transType	退款填写“REFD”
4	订单号	60	文本	orderNum	商户自行定义，需保证同一商户号下订单号不能重复
5	GW 交易 ID	32	文本	transID	GW 系统生成的交易 ID，每笔交易保持唯一
6	商户代码	15	文本	merID	商户 ID，由AllPay 分配
7	收单行 ID	11	文本	acqID	收单行 ID "99020344"
8	交易应答码	2	文本	RespCode	应答码 00-成功
9	应答文字信息	20	文本	RespMsg	应答消息，全部为英文字符
10	交易时间	14	文本	transTime	交易时间,格式:"yyyyMMddHHmmss"
11	GW 处理时间	14	文本	GWTime	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
12	签名类型	3	文本	signType	MD5
13	签名	32	文本	signature	采用 MD5 签名