4.1.9.4服务单主动支付预下单通知


使用场景:

  1. 持卡人可以在微信端主动发起服务单的付款,持卡人点击付款后,微信会向商户发起预下单通知,商户需在通知返回支付单的信息

  2. 通知类型(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分钟


yinjr 2024年7月30日 15:49 收藏文档