Go语言实现支付宝支付与退款详解

更新时间：2024年10月16日 10:31:35 作者：tatasix

本文详细介绍使用Go语言对接支付宝支付与退款功能的步骤和注意事项,包括PC端、WAP端和Android端支付实现,以及退款功能的代码实现,介绍了GoPay库的使用,帮助开发者快速集成支付宝支付到应用中

在当今数字支付的时代，移动支付已经成为各行各业的主流选择。支付宝作为中国最大的支付平台之一，提供了丰富的支付和退款API，供开发者集成到各种应用中。上期我已经介绍了 Go语言对接微信支付。本文将详细介绍如何使用Go语言对接支付宝的支付与退款功能，通过实例代码来讲解关键步骤和注意事项。

一、准备工作

在开始编码之前，你需要准备以下几项：

注册成为支付宝支付商户：注册并登录支付宝开放平台，获取必要的AppID、商户ID（MchId）、私钥等信息。

获取必要的配置信息：

Appid：支付宝应用的唯一标识。
MchId：商户号。
PrivateKey：开发者的私钥，用于生成支付签名。
PublicKey：支付宝的公钥，用于验证回调签名。
NotifyUrl：支付结果通知地址。
ReturnUrl：支付成功后用户跳转的地址。

安装第三方库：安装GoPay库，这是一个Go语言的支付宝SDK，可以简化开发流程。

go get github.com/go-pay/gopay

二、初始化配置

首先，我们需要定义支付相关的配置信息，包括应用ID、商户ID、私钥等：

type Config struct {
	Appid      string
	MchId      string
	PrivateKey string
	NotifyUrl  string
	RefundUrl  string
	ReturnUrl  string
	PublicKey  string
	QuitUrl    string
}

通过 go-pay 的 alipay.NewClient 方法，我们可以轻松初始化支付宝客户端。以下是如何在Go中初始化Alipay服务：

func NewAlipayService(ctx context.Context, config Config) *AlipayService {
    alipayCli, err := alipay.NewClient(config.Appid, config.PrivateKey, true)
    if err != nil {
        panic(err)
    }
    alipayCli.DebugSwitch = gopay.DebugOn // 开启debug
    alipayCli.SetCharset(alipay.UTF8).SetSignType(alipay.RSA2)
    
    return &AlipayService{
        ctx:    ctx,
        config: config,
        alipay: alipayCli,
    }
}

三、实现支付功能

1. 付款时序图

支付时序图

2. 实现不同场景下的支付

1. 实现PC端支付

PC端支付通过生成支付链接并提供给用户，用户通过扫码或点击链接完成支付。下面是PC端支付的实现：

// PcPay PC端支付
func (a *AlipayService) PcPay(charge *Charge) (string, error) {
	a.alipay = a.alipay.SetReturnUrl(a.config.ReturnUrl).SetNotifyUrl(a.config.NotifyUrl)
	// 生成单号
	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 构造参数
	bm := make(gopay.BodyMap)
	bm.Set("subject", charge.Describe).
		Set("out_trade_no", charge.TradeNum).
		Set("total_amount", amount).
		Set("qr_pay_mode", 4).
		Set("qrcode_width", 120)
	// 发起支付
	return a.alipay.TradePagePay(a.ctx, bm)
}

此函数中，我们将支付的关键参数（如商品描述、订单号、支付金额等）传递给支付宝SDK，支付宝返回生成的支付二维码，用户通过扫码即可完成支付。

2. 实现WAP端支付

移动端支付（WAP端）与PC端支付类似，但需要额外处理 quit_url 参数，该参数决定用户在支付取消后跳转的地址。

// WapPay WAP端支付
func (a *AlipayService) WapPay(charge *Charge) (string, error) {
	a.alipay = a.alipay.SetReturnUrl(a.config.ReturnUrl).SetNotifyUrl(a.config.NotifyUrl)
	// 生成单号
	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 构造参数
	bm := make(gopay.BodyMap)
	bm.Set("subject", charge.Describe).
		Set("out_trade_no", charge.TradeNum).
		Set("total_amount", amount).
		Set("quit_url", a.config.QuitUrl+a.config.QuitUrl).
		Set("product_code", "FAST_INSTANT_TRADE_PAY")
	// 发起支付
	return a.alipay.TradeWapPay(a.ctx, bm)
}

3. 实现Android端支付

在Android端，支付宝提供了App支付方式。通过生成支付参数，客户端可以调用支付宝App完成支付流程。以下是Android端支付的代码：

// AndroidPay Android端支付
func (a *AlipayService) AndroidPay(charge *Charge) (string, error) {

	a.alipay.SetNotifyUrl(a.config.NotifyUrl)

	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 构造参数
	bm := make(gopay.BodyMap)
	bm.Set("subject", charge.Describe).
		Set("out_trade_no", charge.TradeNum).
		Set("total_amount", amount).
		Set("product_code", "FAST_INSTANT_TRADE_PAY")
	// 发起支付
	return a.alipay.TradeAppPay(a.ctx, bm)
}

3. 支付结果回调

当用户完成支付后，支付宝会向您的服务器发送支付结果的通知。您需要解析这些通知并验证其有效性：

// AliWebPayResult 支付宝支付结果回调
type AliWebPayResult struct {
	OutTradeNo  string `json:"out_trade_no"`
	TradeStatus string `json:"trade_status"`
}

// GetNotifyResult  解析支付回调
func (a *AlipayService) GetNotifyResult(r *http.Request) (result *AliWebPayResult, err error) {
	// 解析异步通知的参数
	notifyReq, err := alipay.ParseNotifyToBodyMap(r)
	if err != nil {
		// TODO 处理错误信息
		return
	}

	// 支付宝异步通知验签（公钥模式）
	_, err = alipay.VerifySign(a.config.PublicKey, notifyReq)
	if err != nil {
		// TODO 处理错误信息
		return
	}
	if err = notifyReq.Unmarshal(result); err != nil {
		// TODO 处理错误信息
		return
	}
	return
}

四、退款功能实现

退款时序图

支付宝退款时序图

支付宝退款跟微信退款不一样的，支付宝退款的结果是接口直接返回的，而不是异步通知的，发起退款的时候也不支持回调通知

发起退款

退款操作的关键是构造正确的退款参数，并通过支付宝API发起退款请求。下面是退款的代码实现：

// RefundCharge 退款参数
type RefundCharge struct {
   TradeNum     string `json:"tradeNum,omitempty"`
   MoneyFee     int64  `json:"MoneyFee,omitempty"`
   OutRefundNo  string `json:"out_refund_no,omitempty"`
   RefundReason string `json:"refund_reason,omitempty"`
}


func (a *AlipayService) Refund(charge *RefundCharge) (err error) {
	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 构造参数
	bm := make(gopay.BodyMap)
	bm.Set("out_trade_no", charge.TradeNum).
		Set("refund_reason", charge.RefundReason).
		Set("out_request_no", charge.OutRefundNo).
		Set("refund_amount", amount)
	// 发起支付
	res, err := a.alipay.TradeRefund(a.ctx, bm)
	//TODO 处理错误信息，处理结果
	return
}

五、总结

本文通过Go语言结合 go-pay 库，详细介绍了如何对接支付宝的PC端支付、WAP端支付、Android端支付以及退款功能。通过合理的封装和错误处理，开发者可以快速集成支付宝支付功能到自己的项目中。希望本文能够帮助到有支付集成需求的开发者，在实际开发中提升效率。

更多支付宝API细节，请参考支付宝官方文档。

到此这篇关于Go语言实现支付宝支付与退款详解的文章就介绍到这了,更多相关Go语言支付宝支付内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

GO语言支付宝沙箱对接的实现

一文带你使用golang手撸一个websocket中间件
这篇文章主要为大家详细介绍了如何使用golang手撸一个websocket中间件,文中的示例代码讲解详细,具有一定的借鉴价值,感兴趣的小伙伴可以参考一下
2023-12-12
Go语言开发实现一个图片批量压缩工具
在日常开发和办公中,图片体积过大会带来不少困扰,本文将使用Go语言编写一个图片批量压缩工具,文中的示例代码讲解详细,需要的可以了解下
2025-09-09
go语言标准库fmt包的一键入门
这篇文章主要为大家介绍了go语言标准库fmt包的一键入门使用示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-08-08
golang slice元素去重操作
这篇文章主要介绍了golang slice元素去重操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-04-04
golang语言编码规范的实现
这篇文章主要介绍了golang语言编码规范的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-03-03
Go习惯用法(多值赋值短变量声明赋值简写模式)基础实例
本文为大家介绍了Go习惯用法（多值赋值,短变量声明和赋值,简写模式、多值返回函数、comma,ok 表达式、传值规则）的基础实例,帮大家巩固扎实Go语言基础
2024-01-01
基于go语言实现图片验证码的代码示例
这篇文章主要为大家详细介绍了基于go语言实现图片验证码的代码示例,文中的示例代码简洁易懂,具有一定的借鉴价值,感兴趣的小伙伴可以跟随小编一起学习一下
2023-10-10
Golang学习之内存逃逸分析
内存逃逸分析是go的编译器在编译期间，根据变量的类型和作用域，确定变量是堆上还是栈上。本文将带大家分析一下Golang中的内存逃逸，需要的可以了解一下
2023-01-01
goweb模板语法html/template
在Go语言里, html/template 包主要用于安全地生成HTML输出,它能够有效防止跨站脚本攻击（XSS）,借助模板语法将数据动态填充到HTML文件中,下面就来详细的介绍一下
2026-02-02
goland最新激活办法
这篇文章主要介绍了goland最新激活办法,激活方法真的超级简单，只需要把脚本内容复制到对应文件，并运行该脚本就可以了，需要的朋友可以参考下
2021-12-12