小程序下单

接口说明
公共请求参数
业务请求参数
Memo参数域
渠道选项
付款方信息
前端回调地址
公共请求示例
业务请求示例
公共响应参数
业务响应参数
公共响应示例
业务响应示例
交易状态码
交易响应码

小程序支付是指商户通过微信或者企业微信内的订货小程序按照微企付的协议生成支付链接，跳转微企付小程序进行付款的场景。

接口说明

测试请求URL：https://test-api.huishouqian.com/api/acquiring

生产请求URL：https://api.huishouqian.com/api/acquiring

请求方式：POST

公共请求参数

变量	参数名	类型[长度限制]	必填	描述
method	方法名	string[1,32]	是	POLYMERIZE_MAIN_SWEPTN
version	版本	string[1,16]	是	接口版本：1.0
format	请求格式	string[1,16]	是	业务请求参数格式，支持：JSON
merchantNo	商户号	string[1,16]	是	商户在慧收钱的商户号，由慧收钱生成并下发
signType	加密类型	string[1,16]	是	RSA2:签名机制查看说明
signContent	业务数据	string	是	业务请求参数
sign	签名数据	string[1,128]	否	签名数据

业务请求参数

量变	参数名	类型[长度限制]	必填	描述
subMerchantNo	门店编号	string[1,32]	否	商户在支付平台创建生成的门店编号
transNo	商户订单号	string[1,64]	是	商户系统内部订单号，唯一不重复
payType	交易类型	string[1,32]	是	WQF_APPLET：微企付小程序支付
returnUrl	后端通知地址	string[1,128]	是	当交易有结果时，用户支付完成后，慧收钱服务器主动通知商户服务器里指定地址示例值：`https://www.merchant.com/xxx`
orderAmt	交易金额	string[1,16]	是	交易金额，单位为：分示例值：1
goodsInfo	商品信息	string[1,128]	是	商品说明示例值：iphone商品
requestDate	交易时间	string[1,14]	是	请求时间，与当前系统时间相差小于10分钟，格式[yyyyMMddHHmmss] 示例值：20190101140908
extend	附加字段	string[1,128]	否	附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用示例值：自定义数据
memo	扩展信息	string[1,512]	否	json格式，将如下参数转json

Memo参数域

变量	参数名	类型[长度限制]	必填	描述
timeExpire	交易结束时间	string[1,14]	否	订单失效时间，格式[yyyyMMddHHmmss]，建议：最短失效时间间隔大于1分钟示例值：20190101140908
spbillCreateIp	终端用户IP	string[1,32]	是	消费者端IP，支持ipv4、ipv6格式示例值：123.12.12.123
longitude	经度	string[1,32]	否	交易所在地经度用于交易地点定位
latitude	纬度	string[1,32]	否	交易所在地纬度用于交易地点定位
areaInfo	区域信息	string[1,7]	否	银联选填区域信息长度固定7
channel_options	渠道选项	object	否	用于微企付APP支付指定收银台支持的付款渠道
payer_options	付款方信息	array[object] (1,2)	否	用于微企付app支付指定付款方信息列表。支持：指定付款类型（个人/企业）、指定付款方名称（个人姓名/企业名称）, 指定付款卡号，可同时支持上送不多于2个付款方信息。注意payer_options是动态数组
front_callback_url	前端回调地址	object	是	商户客户端侧需提供可换起APP的固定URLScheme给后台，用户支付的时候会跳到银行app，支付完成后会根据这个地址回跳到商户app

渠道选项

变量	参数名	类型[长度限制]	必填	描述
include_bank_snames	指定银行简称列表	array[String(1,64)]	否	银行简称，指定收银台支持的银行列表，例如平安银行为：PAB
exclude_bank_snames	指定排除银行简称列表	array[String(1,64)]	否	银行简称，指定收银台支持的银行列表，例如平安银行为：PAB
include_pay_channels	指定支付渠道列表	array[String]	否	枚举值： INDIVIDUAL:个人银行卡 ENTERPRISE:企业网银
exclude_pay_channels	指定排除支付渠道	array[String]	否	枚举值： INDIVIDUAL:个人银行卡 ENTERPRISE:企业网银

付款方信息

变量	参数名	类型[长度限制]	必填	描述
assign_pay_type	指定付款类型	enum	否	枚举值： INDIVIDUAL:个人付款 ENTERPRISE:企业付款
payer_name	付款方名称	string(1, 128)	否	加密参数。付款方名称，当assign_pay_type为ENTERPRISE时，该字段必须设置为付款企业名称，当assign_pay_type为INDIVIDUAL时，该字段必须设置为指定个人付款人姓名

前端回调地址

变量	参数名	类型[长度限制]	必填	描述
mp_path	Mp 支付完成前端回跳小程序路径	string(1, 1024)	是	Mp 支付完成前端回跳小程序路径，路径和参数内容由开发者设置，受环境限制目前腾讯微企付在 iOS 里使用 wx.navigateBackMiniProgram ，在 Android 里使用wx.navigateToMiniProgram 回跳到你的小程序，建议路径为订单详情或结果页，onShow 时查询最新的订单状态按需展示
mp_appid	Mp 支付完成前端回跳小程序appid	string(1, 64)	是
mp_username	Mp 支付完成前端回跳小程序原始id	string(1, 64)	是
mp_urlscheme	Mp 支付完成前端回跳小程序urlscheme	string(1, 64)	是

公共请求示例

{method=POLYMERIZE_MAIN_SWEPTN, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

{
"extend":"222,11",
"payType":"WQF_APPLET",
"transType":"2",
"requestDate":"20241014094420",
"memo":"{\"timeExpire\":\"\",\"timeStart\":\"\",\"idType\":\"1\",\"idName\":\"\",\"openid\":\"\",\"appid\":\"\",\"latitude\":\"\",\"front_callback_url\":\"{\\\"mp_appid\\\":\\\"https://h5.dsibc.com/api/payCallback/pgCallback/ALI_H5/\\\",\\\"mp_username\\\":\\\"1111\\\",\\\"mp_path\\\":\\\"https://h5.dsibc.com/api/payCallback/pgCallback/ALI_H5/\\\",\\\"mp_urlscheme\\\":\\\"222222\\\"}\",\"idNo\":\"\",\"spbillCreateIp\":\"\",\"paylimit\":\"\",\"longitude\":\"\"}",
"orderAmt":"1",
"totalOrderAmt":"1",
"transNo":"202410140944207361622463",
"returnUrl":"",
"unionInfo":"",
"goodsInfo":"微企付小程序商品信息",
"bizOrderNo":""
}

公共响应参数

变量	参数名	类型[长度限制]	必填	描述
success	响应状态	string[1,32]	是	服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode	错误码	string[1,32]	否	响应码
errorMsg	错误描述	string[1,128]	否	响应描述
result	响应内容	string	否	业务响应参数
sign	签名数据	string[1,128]	否	响应验签数据

业务响应参数

变量	参数名	类型[长度限制]	必填	描述
transNo	商户订单号	string[1,64]	是	原样返回商户订单号
tradeNo	交易订单号	string[1,32]	是	慧收钱交易订单号
orderAmt	交易金额	string[1,16]	是	订单交易金额
orderStatus	交易状态	string[1,16]	是	详见交易状态码
finishedDate	完成时间	string[1,14]	否	交易完成时间，格式[yyyyMMddHHmmss] 示例值：20190101140908
respCode	错误码	string[1,32]	否	详见交易响应码
respMsg	错误信息	string[1,128]	否	详见交易响应码
qrCode	预支付交易会话标识	string[1,1024]	是	返回唤醒微企付收银台的参数，唤醒方式可参考：微信
channelOrderNo	慧收钱上送三方支付的交易订单号	string[1,64]	是	慧收钱上送三方支付的交易订单号

公共响应示例

{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}

业务响应示例

{
"channelOrderNo":"WQ010190000000000000000181199649",
"extend":"222,11",
"orderAmt":"1",
"orderStatus":"PROCESSING",
"payType":"WQF_APPLET",
"qrCode":"{\"mp_appid\":\"wx1121decaed78f83f\",\"mp_path\":\"pages/checkout/counter?q=https%3A%2F%2Fsandbox.businesspay.qq.com%2Fmse%2Fwx%2Fcheckout%3Fp%3Dat%253D99%2526e%253Dsandbox%2526oi%253DAPPTMS000100202410143502900006%2526pi%253Dsandbox4010020005778100%2526sk%253DAAAAAgAAAPAAAAABAAAAKQAAAABnDHd3AAAAAGcMk5cAAABjAAAAAW9yZGVyX2lkJnBsYXRmb3JtX2lkLnsidCI6IjEiLCJzY2VuZSI6OTZ9V0hGNm0wYWpoQzI5VVBJeWlZOXZ2MDkza1VVVVk3NFFGT2JDUlRXN3FKdDlOdG11V2hVV1Z4aFRIVlVZVVcycUszdWE2ZkVmWWRjMm9JRTdhMGJRU29nd0ttM3BkTTNocGFjamtHS0pIOUV4S0UvWEhUay9mWEtpU0FxTWkweXN6SXlFNHFVU2NRZUlNaENsMzNMQVpOaXl1a1RQcEZ0WmRjaHVEQzNONDBrPQ%25253D%25253D%2526spi%253D\",\"mp_username\":\"gh_918a17273472\",\"mp_version\":\"trial\"}",
"respCode":"100201",
"respMsg":"交易处理中，请稍后查询",
"tradeNo":"25010120241014094420900421223464",
"transNo":"202410140944207361622463"
}

交易状态码

状态码	描述
INIT	初始化
PROCESSING	处理中
SUCCESS	成功
FAIL	失败

交易响应码

响应码	描述	解决方案
100004	不支持该支付通道的交易
100019	无可用渠道
100200	订单已支付成功，请勿重复支付
100203	交易失败
100204	订单已过期，请使用新的订单号发起交易
100205	订单已存在
100206	订单不存在
100207	交易已取消
100208	订单已失败
100209	交易失败，黑名单用户
100210	交易失败，非白名单用户
100211	交易记录不存在
100212	交易失败，风险受限
100500	余额不足
100501	交易金额超限
100502	交易金额低于限额
100503	交易金额不正确
100505	单日交易金额超限
100506	单笔交易金额超限
100507	单月交易金额超限
100600	短信验证码错误
100601	短信验证码失效
100602	请确认是否发送短信,当前交易必须通过短信验证
200002	非法的交易
200003	订单号已存在，请勿重复提交
200004	订单不存在
200005	原订单金额校验不通过
200010	批次号已存在
200011	订单数量超过单批次处理量
200012	请求太过频繁,请稍后再试
200015	不支持此支付类型
200017	订单关闭成功
200018	订单关闭失败,请重试！
200107	分账参数校验异常
200108	交易主体从属关系异常
200109	业务订单不存在
200110	业务订单状态异常
200111	支付金额超限
200112	业务订单已失效
200113	该业务订单不支持部分支付
200114	业务订单已关闭
200115	非法交易
200116	存在成功/处理中订单,请勿重复提交
200117	订单已经分账不能发起退款/撤销
200118	订单金额不等于交易金额+营销金额
200119	订单金额+交易金额不能都为0
200120	营销账户信息不能为空
200201	商户状态异常，无法进行交易
200203	商户与子商户关系不对应，无法进行交易
200204	门店信息不存在，无法进行交易
200205	终端商户信息不存在，无法进行交易
200206	请求ip白名单未配置
200207	账户状态异常
200209	门店信息不存在
200210	设备信息不存在
200302	产品渠道不能为空
300401	交易非法，订单已完成
300701	商户限额校验不通过

作者：xiaochen 创建时间：2024-10-12 15:41
最后编辑：xiaochen 更新时间：2025-04-24 20:39