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

tatasix

于 2024-10-10 17:15:00 发布

阅读量732

点赞数 18

分类专栏： go 文章标签： golang 后端

本文链接：https://blog.csdn.net/tatasix/article/details/142818156

版权

go 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

文章目录

在当今数字支付的时代，移动支付已经成为各行各业的主流选择。支付宝作为中国最大的支付平台之一，提供了丰富的支付和退款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
}