wxlogin微信扫码登录API - 简单设置即可实现微信PC扫码、H5和静默登录

概述

wxlogin平台为开发者提供简单易用的微信登录和微信支付接口服务。通过我们的平台，您可以无需经过复杂的微信官方认证流程，快速为您的应用接入微信登录和支付功能。

💡

核心优势：
• 无需企业认证，个人开发者即可使用
• 接入简单，3步即可完成对接
• 支持PC扫码、H5、微信内多种场景
• 数据加密传输，安全可靠

接入流程

1

注册账号

→

2

创建应用

→

3

获取AppID和密钥

→

4

配置接口

→

5

开始使用

快速开始

1. 注册并创建应用

首先需要在wxlogin平台注册账号，然后在"我的网站"中创建一个新的应用。创建成功后，您将获得唯一的 AppID 和 AppSecret。

2. 配置回调地址

在应用设置中配置您的回调地址，用于接收微信登录和支付的结果通知。

配置示例

// 您的应用配置
$config = [
    'appid' => '您的AppID',
    'secret' => '您的AppSecret',
    'callback_url' => 'https://yourdomain.com/callback.php',
    'pay_notify_url' => 'https://yourdomain.com/pay_notify.php'
];

微信登录接口

PC扫码登录地址

使用JWT加密，适用于PC网站，跳转到二维码登录界面，用户扫码登录后，会返回data数据到后台配置的PC返回地址。

请求URL

// PC端扫码登录
https://wxlogin.com/jwt?appid={您的AppID}

H5登录地址

使用JWT加密，适用于微信H5网页，无需扫码，授权登录后会返回后台配置的H5返回地址。

请求URL

// H5端登录
https://wxlogin.com/jwth5?appid={您的AppID}

请求参数

参数	说明
appid	应用id
scope	snsapi_userinfo 或 snsapi_base
tpl	扫码页面风格ID，默认是1，可选2、3

💡

scope参数说明：
• snsapi_userinfo 需要用户点击授权按钮，可获得用户昵称和头像
• snsapi_base 静默登录只获取openid

返回数据

登录成功后返回加密的数据和token。

⚠️

返回示例：
假设后台网站设置的PC返回地址为：https://note.5811.cn/main/return

data: 是加密数据
token: 是当前用户密钥

返回URL示例：
https://note.5811.cn/main/return?data=ZnpONXZkUlZD***UDgc6XJ&token=sdfwwUUISD234sdfe

方法一：通过token获取用户信息【推荐】

扫码登录后，返回的url里面包含一个token参数，通过token使用下面的接口即可获取当前用户资料，无需解密。

接口信息

// 通过token获取登录用户资料
接口地址：https://wxlogin.com/wxuser/userinfo
请求方式：POST
Head头部：Content-Type: application/json

返回数据示例

{
    "code": 200,
    "msg": "获取成功",
    "data": {
        "id": "672",
        "appid": "wxB2WA_9i2KK",
        "openid": "6a235gjyv2ZpnAuSZ8rMKXHdTygLb7wMAHdfM0KuLURmVwUtuhNdO09bGWBRi1A9",
        "unionid": null,
        "nickname": "曹え 5811",
        "sex": "0",
        "province": null,
        "city": null,
        "country": null,
        "headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/***oZB6jHEyIa3b9ee46xf8iaItypib0g8/132",
        "addtime": "2025-03-27 11:16:24",
        "logintime": "2025-10-24 11:05:27",
        "wx_openid": "o-B8Qt1OeLeIM2Yh8mJLiT3nulJg",
        "token": "qIeHaA1kCLfh4Wt0xHK_9FxYxrupjS9e"
    }
}

方法二：解密后得到json

接收 data 数据，配合应用key解密得到用户信息。

解密后的JSON数据

{
    "appid": "wx8888888888",
    "openid": "AZf_FAVqS84myGfwQOuq6oIZZQIv5bU7171580072",
    "nickname": "曹え5811",
    "headimgurl": "https://thirdwx.qlogo.cn/mmopen/vi_32/***Ia3b9ee46xf8iaItypib0g8/132",
    "sex": "0"
}

解密参数说明

参数	说明
appid	应用id
openid	用户的openid
nickname	微信昵称
headimgurl	微信头像
sex	性别

微信支付接口

✨

v1.4.0 更新说明：
• 统一使用JSAPI支付，体验更好
• PC端扫码跳转H5支付页面，支付成功后自动跳转
• H5端直接调起微信支付
• 支持 mode 参数指定支付模式

支付模式说明

模式	触发条件	展示方式
PC模式	mode=pc 或 PC浏览器访问	显示二维码 + 轮询查询状态
H5模式	mode=h5 或移动端/微信访问	显示支付按钮，调起JSAPI
H5扫码模式	PC二维码被扫码访问	自动调起JSAPI支付

支付流程

1

生成订单数据

→

2

JWT加密

→

3

跳转支付页面

→

4

用户支付

→

5

回调通知

发起支付请求

将用户引导至以下URL进行微信支付：

请求URL

// 支付页面入口
https://wxlogin.com/pay?appid={您的AppID}&data={JWT加密的订单数据}&mode={支付模式}

请求参数

参数名	类型	必填	说明
appid	string	必填	您在平台创建应用时获得的AppID
data	string	必填	JWT加密的订单数据
mode	string	可选	支付模式：pc/h5，不传则自动判断

订单数据格式（JWT加密前）

JSON

{
    "out_order_no": "商户订单号",
    "amount": 100.00,
    "product_name": "商品名称",
    "product_img": "商品图片URL",
    "product_desc": "商品描述",
    "return_url": "支付成功后跳转URL",
    "time": 1234567890,
    "expire": 1234567990
}

订单数据参数说明

参数名	类型	必填	说明
out_order_no	string	可选	商户订单号，用于对账
amount	float	必填	支付金额，单位：元
product_name	string	必填	商品名称
product_img	string	可选	商品图片URL
product_desc	string	可选	商品描述
return_url	string	可选	支付成功后跳转URL
time	int	可选	请求时间戳
expire	int	可选	过期时间戳

生成支付链接示例

PHP

// 订单数据
$orderData = [
    'out_order_no' => 'ORDER' . time(),
    'amount' => 99.00,
    'product_name' => 'VIP会员',
    'product_desc' => '购买VIP会员1个月',
    'return_url' => 'https://yourdomain.com/pay/success',
    'time' => time(),
    'expire' => time() + 900  // 15分钟后过期
];

// JWT加密（使用您的AppSecret作为密钥）
$data = JWT_encode($orderData, $appSecret);

// 生成支付URL
$payUrl = 'https://wxlogin.com/pay?appid=' . $appid . '&data=' . urlencode($data);

// 跳转到支付页面
header('Location: ' . $payUrl);

查询订单状态

可通过API查询订单支付状态，用于PC端轮询或其他场景：

请求URL

GET https://wxlogin.com/pay/query?appid={AppID}&order_no={订单号}

响应示例

{
    "code": 200,
    "msg": "查询成功",
    "data": {
        "order_no": "平台订单号",
        "out_order_no": "商户订单号",
        "amount": 100.00,
        "status": 1,  // 0=待支付 1=已支付
        "pay_time": "2024-01-01 12:00:00",
        "transaction_id": "微信交易号"
    }
}

回调处理

用户完成微信登录授权后，平台会将加密的用户信息回调到您设置的callback地址。

⚠️

注意事项：
• 回调地址必须支持HTTPS协议
• 回调数据使用您的AppSecret加密，请妥善保管密钥

错误码说明

错误码	说明	解决方案
10001	AppID不存在	请检查AppID是否正确
10002	应用已禁用	请联系管理员处理
20001	数据解密失败	请检查AppSecret是否正确

💬

技术支持：
如遇到其他问题，请访问我们的网站获取帮助。

API 接口文档

概述

接入流程

快速开始

1. 注册并创建应用

2. 配置回调地址

微信登录接口

PC扫码登录地址

H5登录地址

请求参数

返回数据

方法一：通过token获取用户信息【推荐】

方法二：解密后得到json

解密参数说明

微信支付接口

支付模式说明

支付流程

发起支付请求

请求参数

订单数据格式（JWT加密前）

订单数据参数说明

生成支付链接示例

查询订单状态

回调处理

错误码说明