获取用户 OPENID

当需要获取用户的openid时,参照此文档执行即可。

扫码请求步骤:

  1. 构建请求参数
  2. POST 参数到请求地址
  3. 根据返回内容展示二维码
  4. 用户支付成功后接收异步通知

接口地址

请求参数

** 请求参数在 querystring 中传递。

字段名称 字段类型 必填参数 说明
mch_id integer Y 商户号
sign string Y 数据签名 详见签名算法
callback_url string Y 回调地址,需要 urlencode 处理
scope string N 微信授权scope,可选值为snsapi_basesnsapi_userinfo,不传默认为 snsapi_userinfo

注意:

  • 两种 scope 的区别请查看微信官方文档
  • callback_url 必须为可直接访问的url,不能带session验证、csrf验证
  • 获取openid成功后,会调转到 callback_url 地址,并携带 openid 参数
  • 该接口不能在小程序中直接使用;不能在微信开发者工具里调试,需真机调试
  • openid 具备唯一性,可做映射关系存储在本地数据库

正确返回

字段名称 字段类型 必填参数 说明
mch_id integer Y 商户号
openid string Y 用户的openid

流程示例

假如需要接收 openid 的 url 是:

http://www.example.com/abc

则直接通过浏览器跳转该 url 即可:

https://api.paycats.cn/v1/wx/openid?mch_id=1234567890&callback_url=http%3a%2f%2fwww.example.com%2fabc

完成 openid 获取后,微信浏览器会自动跳转至:

http://www.example.com/abc?mch_id=12344&openid=*************