使用场景:
-
持卡人可以在微信端主动发起服务单的付款,持卡人点击付款后,微信会向商户发起预下单通知,商户需在通知返回支付单的信息
-
通知类型(event_type)为PAYSCORE.MCH_PREPAY,微信会以返回的预下单信息进行下一步的扣款
请求参数(bizdata):
参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
---|---|---|---|---|---|
out_order_no | 商户订单号 |
商户系统内部服务订单号(不是交易单号) 要求32个字符内,只能是数字、大小写字母 且在同一个商户号下唯一 |
否 | String(32) | |
chnl_order_no | 渠道服务单号 | 渠道服务单号(不是交易单号)对应微信端的商户单号 | 否 | String(32) | |
serviceid | 服务id | 微信分配的服务id | 否 | String(32) | |
openid | 用户标识 | 通联机构的openid | 是 | String(128) | |
sub_appid | 子商户公众号ID | 子商户公众号AppID | 是 | String(32) | |
sub_mchid | 子商户商户号 | 否 | String(32) | ||
sub_openid | 子商户的用户标识 | 子商户的AppID下的用户标识 | 是 | String(128) | |
channel_id | 渠道商商户号 | 否 | String(32) | ||
total_amount | 总金额 | 调用接口传入的总金额 | 是 | int | 示例值:40000 |
返回报文:
1.商户支付下单的扣款详情,微信拿到扣款详情信息后,进行下一步的扣款
2.返回报文格式为json,编码UTF-8
参数 | 参数名称 | 取值 | 可空 | 最大长度 | 备注 |
---|---|---|---|---|---|
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 可 | 2 | 默认填12 |
out_order_no | 商户订单号 |
商户系统内部服务订单号(不是交易单号) 要求32个字符内,只能是数字、大小写字母 且在同一个商户号下唯一 |
否 | 32 | |
reqsn | 商户交易单号 | 商户的扣款交易订单号 | 否 | 32 | 保证商户平台唯一 |
serviceid | 服务id | 微信分配的服务id | 否 | 32 | |
trxamt | 交易金额 |
单位为分 和支付单完成金额一致 |
否 | 15 | |
retcode | 下单结果码 |
0000-预下单成功 3999-预下单失败 |
否 | 4 | 预下单结果状态码 |
retmsg | 下单错误信息 | 当错误码为非0000时需返回 | 否 | 128 | |
scene | 交易场景 |
交 易 场 景 的 取 值 包 括 : PARKING—车场停车场场景 PARKING_SPACE—车位停车场GAS—加油场景 HIGHWAY—高速场景 BRIDGE—路桥场景 LIFE_PAY—生活缴费行业 SHARABLE_BIKE—共享单车 SHARABLE_CHARGERS—共享充电宝 E-COMMERCE—电商 OTHERS—其他 |
是 | 32 | |
body | 订单标题 | 订单商品名称,为空则以商户名作为商品名称 | 是 | 100 | 最大100个字节(50个中文字符) |
remark | 备注 | 备注信息 | 是 | 160 | 最大160个字节(80个中文字符) |
notify_url | 交易结果通知地址 | 接收异步通知回调地址,通知url必须为直接可访问的url,不能携带参数。 | 是 | 256 | |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | 32 | |
signtype | 签名方式 | 是 | 8 |
RSA RSA2 SM2 |
|
sign | 签名 | 详见安全规范 | 否 | 32 | |
validtime | 有效时间 | 是 |
不送默认5分钟 根据微信规则 建议超过5分钟 |