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语言微服务中实现链路追踪

    Go语言微服务中实现链路追踪

    在微服务架构中,链路追踪技术可以帮助我们跟踪请求在各个服务之间的传播路径,本文就来介绍一下Go语言微服务中实现链路追踪,感兴趣的可以了解一下
    2024-12-12
  • Go和RabbitMQ构建高效的消息队列系统

    Go和RabbitMQ构建高效的消息队列系统

    本文主要介绍了使用Go语言和RabbitMQ搭建一个简单的消息队列系统,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-01-01
  • Golang构建WebSocket服务器和客户端的示例详解

    Golang构建WebSocket服务器和客户端的示例详解

    这篇文章主要为大家详细介绍了如何使用Go语言构建WebSocket服务器和客户端,以实现双向通信,文中的示例代码讲解详细,需要的小伙伴可以参考一下
    2023-11-11
  • 详解Golang如何实现支持随机删除元素的堆

    详解Golang如何实现支持随机删除元素的堆

    堆是一种非常常用的数据结构,它能够支持在O(1)的时间复杂度获取到最大值(或最小值)。本文主要介绍了如何实现支持O(log(n))随机删除元素的堆,需要的可以参考一下
    2022-09-09
  • Go语言中的闭包详解

    Go语言中的闭包详解

    本文详细讲解了Go语言中的闭包,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • Golang实现超时退出的三种方式

    Golang实现超时退出的三种方式

    这篇文章主要介绍了Golang三种方式实现超时退出,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-03-03
  • GO中 分组声明与array, slice, map函数

    GO中 分组声明与array, slice, map函数

    这篇文章主要介绍了GO中 分组声明与array,slice,map函数,Go语言中,同时声明多个常量、变量,或者导入多个包时,可采用分组的方式进行声明,下面详细介绍需要的小伙伴可以参考一下
    2022-03-03
  • Golang TCP粘包拆包问题的解决方法

    Golang TCP粘包拆包问题的解决方法

    这篇文章主要给大家介绍了Golang TCP粘包拆包问题的解决方法,文中通过示例代码介绍的非常详细,对大家学习或者使用Golang具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-07-07
  • Go语言利用正则表达式处理多行文本

    Go语言利用正则表达式处理多行文本

    在 Go 语言中处理多行文本的正则表达式时,换行符常常会导致意外的匹配结果,本文为大家整理了一些解决方法,有需要的小伙伴可以参考一下
    2024-11-11
  • Golang logrus 日志包及日志切割的实现

    Golang logrus 日志包及日志切割的实现

    这篇文章主要介绍了Golang logrus 日志包及日志切割的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-02-02

最新评论