支付宝第三方登录集成教程：从申请到实现

支付宝第三方登录集成教程

1. 准备工作

在开始之前，您需要完成以下准备工作：

• 拥有一个支付宝开放平台账号（如果没有，请先注册）
• 准备一个待集成的Web或移动应用
• 了解OAuth2.0基本原理

2. 创建应用

2.1 登录支付宝开放平台

访问支付宝开放平台并使用您的支付宝账号登录。

2.2 创建应用

1. 在控制台点击【应用开发】→【自研应用】→【创建应用】
2. 选择应用类型（Web/移动/小程序等）
3. 填写应用基本信息：
   • 应用名称
   • 应用描述
   • 应用图标
4. 配置应用回调地址（用于接收授权码）

2.3 获取应用凭证

创建成功后，系统会生成以下重要信息：

• AppID（应用ID）
• APP私钥
• 支付宝公钥

请妥善保管这些信息，特别是APP私钥，不要泄露给他人。

3. 配置应用

3.1 设置应用权限

根据您的需求，为应用申请相应的API权限：

1. 进入应用详情页
2. 点击【接口权限】
3. 找到【用户授权】相关权限并开启
4. 提交审核（部分权限需要审核）

3.2 配置安全参数

在【应用配置】中设置以下参数：

应用网关地址：https://openapi.alipay.com/gateway.do
返回格式：json
字符编码：utf-8
签名方式：RSA2

4. 代码实现

4.1 前端代码

<!-- 支付宝登录按钮 -->
<div id="alipay-login-btn" class="alipay-login">
    <img src="alipay-logo.png" alt="支付宝登录">
    <span>使用支付宝登录</span>
</div>

// 初始化支付宝登录
function initAlipayLogin() {
    // 创建登录实例
    var login = new AlipayLogin({
        appId: '您的AppID',
        scope: 'auth_user', // 请求用户授权
        redirectUri: 'https://您的网站.com/auth/alipay/callback'
    });
    
    // 绑定点击事件
    document.getElementById('alipay-login-btn').addEventListener('click', function() {
        login.authorize();
    });
}

// 处理授权回调
function handleAuthResponse(response) {
    if (response.code) {
        // 发送code到后端换取用户信息
        fetch('/api/alipay/auth', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify({ code: response.code })
        }).then(/* 处理响应 */);
    }
}

4.2 后端代码（Node.js示例）

const express = require('express');
const axios = require('axios');
const crypto = require('crypto');
const fs = require('fs');

const app = express();
app.use(express.json());

// 支付宝配置
const ALIPAY_CONFIG = {
    appId: '您的AppID',
    privateKey: fs.readFileSync('./cert/app_private_key.pem', 'utf8'),
    alipayPublicKey: fs.readFileSync('./cert/alipay_public_key.pem', 'utf8'),
    gatewayUrl: 'https://openapi.alipay.com/gateway.do',
    charset: 'utf-8',
    signType: 'RSA2'
};

// 获取access_token
async function getAccessToken(code) {
    const params = {
        app_id: ALIPAY_CONFIG.appId,
        method: 'alipay.system.oauth.token',
        format: 'JSON',
        charset: ALIPAY_CONFIG.charset,
        sign_type: ALIPAY_CONFIG.signType,
        timestamp: new Date().toISOString().replace(/T/, ' ').replace(/\..+/, ''),
        version: '1.0',
        grant_type: 'authorization_code',
        code: code
    };
    
    // 生成签名
    const sign = generateSign(params, ALIPAY_CONFIG.privateKey);
    params.sign = sign;
    
    try {
        const response = await axios.post(ALIPAY_CONFIG.gatewayUrl, querystring.stringify(params), {
            headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
        });
        
        return response.data;
    } catch (error) {
        console.error('获取access_token失败:', error);
        throw error;
    }
}

// 生成签名
function generateSign(params, privateKey) {
    // 排序参数
    const keys = Object.keys(params).sort();
    let paramStr = '';
    
    for (let key of keys) {
        if (params[key] !== null && params[key] !== undefined && params[key] !== '') {
            paramStr += `${key}=${params[key]}&`;
        }
    }
    
    paramStr = paramStr.substring(0, paramStr.length - 1);
    
    // 使用RSA2签名
    const signer = crypto.createSign('RSA-SHA256');
    signer.update(paramStr);
    return signer.sign(privateKey, 'base64');
}

// 路由处理
app.post('/api/alipay/auth', async (req, res) => {
    try {
        const { code } = req.body;
        
        if (!code) {
            return res.status(400).json({ error: '缺少授权码' });
        }
        
        // 获取用户信息
        const result = await getAccessToken(code);
        
        if (result.alipay_system_oauth_token_response) {
            const userInfo = await getUserInfo(result.alipay_system_oauth_token_response.access_token);
            // 处理用户信息...
            res.json({ success: true, user: userInfo });
        } else {
            res.status(400).json({ error: result.sub_code || '授权失败' });
        }
    } catch (error) {
        console.error('支付宝登录失败:', error);
        res.status(500).json({ error: '服务器错误' });
    }
});

// 获取用户信息
async function getUserInfo(accessToken) {
    const params = {
        app_id: ALIPAY_CONFIG.appId,
        method: 'alipay.user.info.share',
        format: 'JSON',
        charset: ALIPAY_CONFIG.charset,
        sign_type: ALIPAY_CONFIG.signType,
        timestamp: new Date().toISOString().replace(/T/, ' ').replace(/\..+/, ''),
        version: '1.0',
        auth_token: accessToken
    };
    
    const sign = generateSign(params, ALIPAY_CONFIG.privateKey);
    params.sign = sign;
    
    try {
        const response = await axios.post(ALIPAY_CONFIG.gatewayUrl, querystring.stringify(params));
        return response.data.alipay_user_info_share_response;
    } catch (error) {
        throw error;
    }
}

app.listen(3000, () => {
    console.log('服务器启动在端口 3000');
});

5. 测试与上线

5.1 沙箱环境测试

1. 在支付宝开放平台切换到【沙箱环境】
2. 使用沙箱账号进行测试
3. 验证所有功能是否正常工作

5.2 正式环境上线

1. 确保所有配置正确无误
2. 提交审核（如果需要）
3. 监控应用运行情况

6. 常见问题及解决方案

6.1 签名验证失败

可能原因：

• 密钥不匹配
• 参数顺序不正确
• 编码问题

解决方案：

• 检查公私钥是否配对
• 确保参数按字母顺序排列
• 统一使用UTF-8编码

6.2 授权回调异常

可能原因：

• 回调地址未正确配置
• 网络问题
• 跨域问题

解决方案：

• 检查回调URL是否正确
• 确保服务器能正常访问
• 配置正确的CORS策略

6.3 权限不足

可能原因：

• 未申请相应权限
• 权限审核未通过

解决方案：

• 检查应用权限配置
• 重新提交权限申请

7. 总结

通过以上步骤，您可以成功集成支付宝第三方登录功能。关键点包括：

1. 正确配置应用信息和密钥
2. 遵循支付宝的API规范
3. 处理好前后端交互逻辑
4. 充分测试后再上线

希望本教程对您有所帮助！如有疑问，欢迎留言讨论。