微信小程序收银台

签名说明：

排除sign参数之外，将其它参数（空值除外）按名称进行字母排序，并和它的取值一起组成name=value样式的字符串，然后用&把它们拼装为一个大字符串，针对goods_detail这种值为对象类型的，直接拼对象对应的json串

app_id=MQ100013&app_name=多点&color=#FF0000&goods_detail=[{"bod
y":"body123456","categories_tree":"5263","goods_category":"5689","goods_id":"id123456","goods_name":"name123456","price":"20","quantity":"20","show_url":"url123456"}]&goods_name=矿
泉水&merch_no=833651658120003&notify_url=http://test.mdun.cn/jd/pay/notice&out_trade_no=test&pn=XN000003&remark=测试交易备注&total_amount=0.05

请求参数(O-非必传 ,M-必传):

参数	参数名称	类型	参数说明	样例	可空
req_id	请求流水号	String(32)	请求流水号，每次请求唯一		M
version	版本号	String(32)	V2		M
merch_no	海科商户编号	String(32)	海科商户编号		M
app_id	平台分配应用ID	String	应用备案通过后分配	请前往开放平台申请或联系渠道经理协助申请	M
app_name	备案应用名称	String	应用备案名称	请前往开放平台申请或联系渠道经理协助申请	M
source	来源标识	String(32)	app:app调用 miniapp:小程序调用		M
pay_type	支付类型	String(10)	WX：微信支付		M
pay_mode	支付方式	String(16)	JSAPI：JSAPI支付		M
sub_mch_id	报备商户编号	String(32)	通道子商户号（ATU商户号）		O
out_trade_no	服务商支付订单号	String(32)	服务商内部订单号（同一服务商下唯一）		M
total_amount	交易金额	String(12)	上送银联的交易金额（单位：元,支持2位小数）		M
pn	SAAS终端号	String(32)	SAAS终端号		M
limit_pay	限制贷记卡支付	String(10)	0：不限制贷记卡支付 1：禁止使用贷记卡支付。不上送此参数时，limit_pay默认为0，即：不限制贷记卡支付		O
color	返回按钮颜色	String	返回按钮自定义颜色		O
ledger_biz	分账业务信息	JSON	分账业务信息		O
notify_url	异步通知地址	String(128)	交易成功异步通知地址		O
remark	备注	String(100)	交易备注		O
longitude	经度	String(10)	经度		O
latitude	纬度	String(10)	纬度		O
extend_params	原生请求参数	JSON	原生参数，透传给通道的参数		O
terminal_info	终端信息	JSON	259终端信息		O
sign	签名	String	SHA256WithRSA 商户私钥加密		M

分账业务信息:ledger_biz

参数	参数名称	类型	参数说明	样例	可空
ledger_type	分账类型	String	REALTIME_SETTLE：实时分账 DELAY_SETTLE：延时分账 BALANCE_SPLIT：余额分账	REALTIME_SETTLE	M
ledger_relation	分账关系组	JSONArray	分账关系组，最多支持10组，实时分账时该参数必传。		O

分账关系组:ledger_relation

参数	参数名称	类型	参数说明	样例	可空
receive_no	收账方(海科商户号)	String	收账方(海科商户号)	833102158124164	M
amt	分账金额	String	分账金额（单位：元）	1	M

259终端信息:terminal_info

参数	参数名称	类型	参数说明	样例	可空
location	终端实时经纬度信息	String	受理终端设备实时经纬度信息，格式为纬度/经度， +表示北纬、东经，-表示南纬、西经	+37.12/-121.213	O
device_ip	商户端设备 IP	String	商户端终端设备 IP 地址。注：如经、维度信息未上送，该字段必送。		O
encrypt_rand_num	加密随机因子	String（10）	仅在被扫支付类交易报文中出现：若付款码为 19 位数字，则取后6 位；若付款码为 EMV二维码，则取其tag 57 的卡号/token 号的后 6 位		O
secret_text	密文数据	String（16）	仅在被扫支付类交易报文中出现：64bit 的密文数据，对终端硬件序列号和加密随机因子加密后的结果。本子域取值为： 64bit 密文数据进行base64 编码后的结果。加密前8位，加密后应为12位		O
app_version	应用程序版本号	String（8）	终端应用程序的版本号。应用程序变更应保证版本号不重复。当长度不足时，右补空格。		O

微信原生请求参数:extend_params

参数	参数名称	类型	参数说明	样例	可空
body	商品描述	String(127)	商品简单描述，该字段请按照规范传递	腾讯充值中心-QQ会员充值	O
goods_tag	微信订单优惠标记	String(32)	微信订单优惠标记，代金券或立减优惠功能的参数		O
device_info	微信设备号	String(32)	终端设备号(门店号或收银设备ID)，注意：PC网页或JSAPI支付请传”WEB”		O
detail	微信商品详情	JSON	微信单品优惠功能		O

微信单品优惠功能:detail

参数	参数名称	类型	参数说明	样例	可空
cost_price	订单原价	int	1.商户侧一张小票订单可能被分多次支付，订单原价用于记录整张小票的交易金额。 2.当订单原价与支付金额不相等，则不享受优惠。 3.该字段主要用于防止同一张小票分多次支付，以享受多次优惠的情况，正常支付订单不必上传此参数。	608800	O
receipt_id	商品小票ID	String(32)	商家小票ID		O
goods_detail	单品列表	JSONArray	单品信息，使用Json数组格式提交		O

微信单品列表:goods_detail

参数	参数名称	类型	参数说明	样例	可空
goods_id	商品编码	String(32)	由半角的大小写字母、数字、中划线、下划线中的一种或几种组成		M
wxpay_goods_id	微信侧商品编码	String(32)	微信支付定义的统一商品编号（没有可不传）		O
goods_name	商品名称	String(256)	商品的实际名称		O
quantity	商品数量	int	用户购买的数量		M
price	商品单价	int	单位为：分。如果商户有优惠，需传输商户优惠后的单价(例如：用户对一笔100元的订单使用了商场发的纸质优惠券100-50，则活动商品的单价应为原单价-50)	528800	M

支付宝原生请求参数:extend_params

参数	参数名称	类型	参数说明	样例	可空
subject	订单标题	String(256)	订单标题。注意：不可使用特殊字符，如 /，=，& 等。	Iphone6 16G	O
operator_id	商户操作员编号	String(28)	商户操作员编号。新当面资金授权场景必填。	yx_001	O
store_id	商户门店编号	String(32)	商户门店编号。新当面资金授权场景必填。	NJ_001	O
terminal_id	商户机具终端编号	String(32)	商户机具终端编号	NJ_T_001	O
goods_detail	订单包含的商品列表信息	JSONArray	订单包含的商品列表信息，json数组格式。		O
extend_params	业务扩展参数	JSON	业务扩展参数		O

支付宝订单包含的商品列表信息:goods_detail

参数	参数名称	类型	参数说明	样例	可空
goods_id	商品编号	String(32)		apple-01	M
goods_name	商品名称	String(256)	商品的实际名称		M
quantity	商品数量	int	用户购买的数量		M
price	商品单价	int	商品单价，单位为元	2000	M
goods_category	商品类目	String（24）	商品类目	34543238	O
categories_tree	商品类目树	String（128）	商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用	分割
body	商品描述信息	String(1000)	商品描述信息		O
show_url	商品的展示地址	String(400)	商品的展示地址		O

支付宝业务扩展参数:extend_params

参数	参数名称	类型	参数说明	可空
sys_service_provider_id	系统商编号	String(64)	该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID	O
hb_fq_num	花呗分期数	String	使用花呗分期要进行的分期数	O
hb_fq_seller_percent	花呗分期数手续费	String	使用花呗分期需要卖家承担的手续费比例的百分值，传入100 代表100%	O
industry_reflux_info	行业数据回流信息	String(512)	行业数据回流信息, 详见：地铁支付接口参数补充说明	O
card_type	卡类型	String(32)	卡类型	O

云闪付原生请求参数:extend_params

参数	参数名称	类型	参数说明	可空
pnrInsIdCd	银联服务商机构号	String	银联服务商机构号，参加银联云闪付活动时上送	O
acqAddnData	收款方附加数据	JSON	收款方附加数据	O
qrCode	二维码地址	String	qrCode必传的值是展示的行业码的内容的值，JSAPI时必传。例如：扫码点餐场景下，qrCode就是传桌面上张贴的二维码的url值。	O
userAuthCode	用户授权码	String	用户授权码，JSAPI时必传	O

(银联二维码)收款方附加数据:acqAddnData

参数	参数名称	类型	参数说明	样例	可空
orderInfo	订单信息	JSON	订单明细内容，如订单标题、订单描述等		O
goodsInfo	商品信息	JSONArray	商品明细内容		O

(银联二维码)订单信息:orderInfo

参数	参数名称	类型	参数说明	可空
title	标题	String	标题	M
description	订单描述	String	订单描述	O
dctAmount	可优惠金额	String	当前订单可以参与优惠计算的金额	O
addnInfo	附加信息	String	内容自定义	O

(银联二维码)商品信息:goodsInfo

参数	参数名称	类型	参数说明	可空
id	标题	String	标题	M
name	商品名称	String	订单描述	M
price	商品单价	String	以分为单位	M
quantity	商品数量	String	商品数量	M
category	商品类目	String	商品类目	O
addnInfo	附加信息	String	附加信息	O

返回参数(O-非必传 ,M-必传):

参数	参数名称	类型	参数说明	可空
status	状态	String	success：支付成功
cancel：取消支付
fail ：支付失败		M
msg	错误描述	String	成功/失败均有值	O

示例

小程序调起收银台小程序

open() {
    var param = 'data={"app_id":"MQ11111","app_name":"多点","color":"#FF0000","goods_detail":[{"goods_id":"id123456","goods_name":"name123456","price":"1","quantity":"20"}],"goods_name":"矿泉水","limit_pay":"1","merch_no":"833102358120220","notify_url":"http://test.mdun.cn/jd/pay/notice","out_trade_no":"miniapp1697700635376","pn":"XN000001","remark":"测试交易备注","source":"miniapp","terminal_info":{"app_version":"23091301","encrypt_rand_num":"928201","secret_text":"968542A5"},"total_amount":"0.01"}&sign=VTkowIfDeSUpy2QYu07UB0U6J5kEuc75s5rRPfwJGis1MSy73EgLUZIhJqKrU/MdlcCwgqRyON/uB/5ZOr/TENw9epRcY3/MLHF5cD9KcqWYGsLhyzYDK6YLe+yCDw0SqyMM7boeuN09nS8MiIVPd1M96aOKJ/wfsBSTdHv+zXAqJAM033etuA3vOUs7nwg5z1pocc5cci7GZVWDKjHOZ+j91+lqMHr9DM+5jSsBjPbmO4DsiGLyuCg4+6lJb1Bf6A6n7iZjOSBIjgXN8tqENGP3XAPxemqIf/iT55QQTsQCyGBFIvV1T4GrNm1yXHSvRjA75bQCgCSBj1xWNbWI6A==';

    wx.openEmbeddedMiniProgram({
      appId: "wxa9494a95118be376",
      path: `/pages/cashier/index?${param}`,
      envVersion: "release"
    });
  }

通过上述方法会调起收银台半屏小程序，在收银台中完成支付后，会回调支付结果，


onShow() {
    wx.onAppShow((res) => {
      if (res.referrerInfo.extraData) {
        console.log(res.referrerInfo.extraData); // {status: "success", msg: "支付成功"}
      }
    })
  }

特殊说明：

一般情况下wx.getEnterOptionsSync()中获取的extraData为收银台小程序返回的支付结果，但是当通过物理返回键或者通过半屏小程序右上角关闭退出（即未通过收银台小程序内按钮退出），extraData内容会为空，调用方小程序会无法获得支付结果，该情况为微信小程序特性，小程序代码无法处理。

如遇到该情况，通过判断场景值为1038且来源小程序为收银台小程序wxa9494a95118be376，即可认定为收银台返回，当前若extraData为空，则需要自行查询订单支付结果

APP调起收银台小程序：

码钱收银原始 ID：gh_495fc43c9560

Android开发示例：

https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/Android_Development_example.html

iOS开发示例：

https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Launching_a_Mini_Program/iOS_Development_example.html

调起方式如上文档，该方式同样适用于小程序打开，此处只展示部分字段，具体字段自行根据业务需求填写：

req.path = "pages/cashier/index?data={"app_id":"MQ10001","app_name":"多点","color":"#FF0000","goods_detail":[{"goods_id":"id123456","goods_name":"name123456","price":"1","quantity":"20"}],"goods_name":"矿泉水","limit_pay":"1","merch_no":"833304458120002","notify_url":"http://test.mdun.cn/jd/pay/notice","out_trade_no":"test1697697220182","pn":"XN000005","remark":"测试交易备注","source":"app","terminal_info":{"app_version":"23091301","encrypt_rand_num":"928201","secret_text":"968542A5"},"total_amount":"0.01"}&sign=EatiG3J2Ppps9QkpqVKvKW2rlxV2E/Vh9nMgJfExPMIwoEjJ3YV5NpIM/nj0c+yArkYVL/9OCEcldj96krNGYjjEeD7BnoeMnOImNx+vhd2Ebsejkf2mvqrx0QYtam0+JcCSzHYSx78cF7aNctvEWZtLwF4EBUA60amIH+dNscxnpri66j2iihG+e5VJIIyN+eMa3VQPrHm/Bnq4Tib/QwzPfFRF47LJhKdLCWCe6Zeg86COQMu6Z+mAUr7+edVpKPV4nCHOMJWQ91nw+c4/Xlwm5dyHTVliXvc6vnHxesDpWEDCYg6QvB2xdSCWF9e/Qfkw7z4y+uv/Jh2WuFh/qw=="

Android小程序回调APP注意事项

WXEntryActivity类文件，需要放置在微信配置应用时填写包名下的wxapi包中，比如当前APP配置包名为“com.allinpaysdk”，则WXEntryActivity需要放在“com.allinpaysdk.wxapi”包中，且该类只能命名为WXEntryActivity，WXEntryActivity以上规范为微信要求，不能修改，否则影响小程序回调APP

特殊说明：

上述文档有说明小程序回调APP说明，但是该回调仅限于在小程序内点击按钮返回APP时有效，但是当通过物理返回键返回APP、任务列表切换回APP、通过半屏小程序右上角关闭退出（即未通过收银台小程序内按钮退出），该回调并不会触发，该情况为微信小程序特性，小程序代码无法处理。

如遇到该情况，建议在APP跳转小程序时新建变量保存跳转标识，在APP内监听到重新打开APP且标志存在，则需要自行查询订单支付结果。

文档更新时间: 2025-04-25 09:43 作者：admin