auth_code
即用户端付款码的内容。微信支付用户端付款码由18位数字组成,10-14开头的为中国大陆用户,支持使用跨境支付,15开头的中国香港用户,当前仅可在中国香港及中国大陆地区使用。
单个付款码的有效期为1分钟,过期后付款码会自动刷新,使用后也会自动失效。
离线状态下,微信客户端会缓存15个付款码供用户在网路情况不佳的情况下使用。但该情况仅适用于非验密场景。
openid
Openid是一个微信号在某个appid下的唯一标识,该ID是一个用户的加密识别字符串。不同微信号在同一个appid下的openid是不同的,同一个微信号在不同appid下的openid也是不同的。
机构可使用该参数来标识用户身份,确认不同订单的用户是否为同一个人。同时商户亦可将用户openid与自有账号体系进行绑定,以便用户信息的触达。
该参数在公众号支付及小程序支付场景下为必传参数。
notify_url
机构在调用统一下单接口时,需要传入回调通知地址notify_url参数,以在支付完成后接收支付回调通知。
notify_url需要填写商户自己系统的真实地址,不能填写接口文档或demo上的示例地址。
notify_url必须是以https://或http://开头的完整全路径地址,并且确保url中的域名和IP是外网可以访问的,不能填写localhost、127.0.0.1、192.168.x.x等本地或内网IP。
notify_url不能携带参数。
常见错误举例:
错误描述 |
示例 |
url中只有域名,缺少具体的路径 |
http://www.weixin.qq.com |
url不是以https://或http://开头,缺少域名或IP |
./PayNotify.aspx |
url中填写了本地或者内网IP |
http://127.0.0.1/pay/notify.php |
填写了不是url格式的字符串 |
xxxxxxx,1234567,test |