Golang版支付宝SDK使用指南

Golang版支付宝SDK使用指南

【免费下载链接】alipay golang SDK for alipay 项目地址: https://gitcode.com/gh_mirrors/alipay5/alipay

本文档提供Golang版支付宝SDK的详细使用说明，帮助开发者快速集成支付宝支付功能到Go应用程序中。

安装SDK

通过Go包管理工具安装支付宝SDK：

go get github.com/ascoders/alipay

安装完成后，您可以在项目中直接引用该库来实现支付宝接口功能。

初始化客户端

在应用启动时，首先需要实例化支付宝客户端并设置必要的配置参数：

import "github.com/ascoders/alipay"

alipayClient := alipay.Client{
    Partner:   "your_partner_id",        // 合作者ID
    Key:       "your_private_key",       // 合作者私钥
    ReturnUrl: "http://yourdomain.com/callback/sync", // 同步回调地址
    NotifyUrl: "http://yourdomain.com/callback/async", // 异步回调地址
    Email:     "seller@example.com",     // 卖家邮箱地址
}

生成支付表单

使用SDK生成支付所需的HTML表单：

form, err := alipayClient.Form(alipay.Options{
    OrderId:  "ORDER123456789", // 唯一订单号
    Fee:      199.99,           // 支付金额，单位为元
    NickName: "买家用户名",       // 用户昵称
    Subject:  "商品描述信息",     // 商品标题
})
if err != nil {
    // 处理错误
}

// 在网页中输出form，实现跳转到支付宝支付页面
fmt.Fprint(w, form)

生成的表单会自动跳转到支付宝收银台页面。

回调处理

支付宝支付完成后会通过同步和异步两种方式回调您的服务器。

同步回调处理

同步回调用于用户支付完成后立即返回的信息验证。

依赖Beego框架的处理方式：

func (c *YourController) Return() {
    result := alipayClient.Return(&c.Controller)
    if result.Status == 1 {
        // 处理成功的订单逻辑
    }
}

无框架依赖的原生处理方式：

func ReturnHandler(w http.ResponseWriter, r *http.Request) {
    result := alipayClient.NativeReturn(r)
    if result.Status == 1 {
        // 处理订单
    }
}

异步回调处理

异步回调确保交易状态的准确更新，处理支付宝的后台通知。

依赖Beego框架的处理方式：

func (c *YourController) Notify() {
    result := alipayClient.Notify(&c.Controller)
    if result.Status == 1 {
        // 更新订单状态等操作
    }
}

无框架依赖的原生处理方式：

func NotifyHandler(w http.ResponseWriter, r *http.Request) {
    result := alipayClient.NativeNotify(r)
    if result.Status == 1 {
        // 处理异步回调事件
    }
}

支付流程说明

支付宝支付流程主要包含四个步骤：

1. 初始化：配置支付宝客户端参数
2. 构造请求：生成支付表单引导用户付款
3. 同步跳转：用户完成支付后同步返回商户页面
4. 异步通知：支付宝后台发送异步通知确认交易状态

关键注意事项

• 安全验证：确保回调处理中的签名验证逻辑正确，避免安全风险
• 防止重复支付：记录订单状态变更，确保同一个订单不被多次扣款
• 订单处理：根据业务逻辑处理订单，不要仅依赖金额参数
• 测试环境：在正式上线前，请在支付宝沙箱环境中进行全面测试

错误代码说明

处理回调时可能遇到的错误代码：

• -1：网站交易号为空
• -2：签名认证失败
• -3：解析表单内容失败
• -4：交易未完成
• -5：未知错误

API版本兼容

当前SDK支持API v2.0版本，同时保持对v1.0版本的兼容性。如需使用v1.0版本API，请参考官方文档中的兼容性说明。

遵循以上文档，您可以轻松集成支付宝支付功能，并确保支付过程的安全性与可靠性。

【免费下载链接】alipay golang SDK for alipay 项目地址: https://gitcode.com/gh_mirrors/alipay5/alipay