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语言支付宝沙箱对接的实现