Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

开发指引

系统设计
合理的查单逻辑
回调信息核验
交易闭环
完整的退款逻辑
开发注意事项
重要参数
API规则
业务启动前的注意事项
业务链接测试
结算及对账

重要参数

在对接微信支付API过程中,有部分重要参数需要额外关注。

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

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global