Go語(yǔ)言實(shí)現(xiàn)支付寶支付與退款詳解

更新時(shí)間：2024年10月16日 10:31:35 作者：tatasix

本文詳細(xì)介紹使用Go語(yǔ)言對(duì)接支付寶支付與退款功能的步驟和注意事項(xiàng),包括PC端、WAP端和Android端支付實(shí)現(xiàn),以及退款功能的代碼實(shí)現(xiàn),介紹了GoPay庫(kù)的使用,幫助開(kāi)發(fā)者快速集成支付寶支付到應(yīng)用中

在當(dāng)今數(shù)字支付的時(shí)代，移動(dòng)支付已經(jīng)成為各行各業(yè)的主流選擇。支付寶作為中國(guó)最大的支付平臺(tái)之一，提供了豐富的支付和退款A(yù)PI，供開(kāi)發(fā)者集成到各種應(yīng)用中。上期我已經(jīng)介紹了 Go語(yǔ)言對(duì)接微信支付。本文將詳細(xì)介紹如何使用Go語(yǔ)言對(duì)接支付寶的支付與退款功能，通過(guò)實(shí)例代碼來(lái)講解關(guān)鍵步驟和注意事項(xiàng)。

一、準(zhǔn)備工作

在開(kāi)始編碼之前，你需要準(zhǔn)備以下幾項(xiàng)：

注冊(cè)成為支付寶支付商戶(hù)：注冊(cè)并登錄支付寶開(kāi)放平臺(tái)，獲取必要的AppID、商戶(hù)ID（MchId）、私鑰等信息。

獲取必要的配置信息：

Appid：支付寶應(yīng)用的唯一標(biāo)識(shí)。
MchId：商戶(hù)號(hào)。
PrivateKey：開(kāi)發(fā)者的私鑰，用于生成支付簽名。
PublicKey：支付寶的公鑰，用于驗(yàn)證回調(diào)簽名。
NotifyUrl：支付結(jié)果通知地址。
ReturnUrl：支付成功后用戶(hù)跳轉(zhuǎn)的地址。

安裝第三方庫(kù)：安裝GoPay庫(kù)，這是一個(gè)Go語(yǔ)言的支付寶SDK，可以簡(jiǎn)化開(kāi)發(fā)流程。

go get github.com/go-pay/gopay

二、初始化配置

首先，我們需要定義支付相關(guān)的配置信息，包括應(yīng)用ID、商戶(hù)ID、私鑰等：

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

通過(guò) go-pay 的 alipay.NewClient 方法，我們可以輕松初始化支付寶客戶(hù)端。以下是如何在Go中初始化Alipay服務(wù)：

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 // 開(kāi)啟debug
    alipayCli.SetCharset(alipay.UTF8).SetSignType(alipay.RSA2)
    
    return &AlipayService{
        ctx:    ctx,
        config: config,
        alipay: alipayCli,
    }
}

三、實(shí)現(xiàn)支付功能

1. 付款時(shí)序圖

支付時(shí)序圖

2. 實(shí)現(xiàn)不同場(chǎng)景下的支付

1. 實(shí)現(xiàn)PC端支付

PC端支付通過(guò)生成支付鏈接并提供給用戶(hù)，用戶(hù)通過(guò)掃碼或點(diǎn)擊鏈接完成支付。下面是PC端支付的實(shí)現(xiàn)：

// PcPay PC端支付
func (a *AlipayService) PcPay(charge *Charge) (string, error) {
	a.alipay = a.alipay.SetReturnUrl(a.config.ReturnUrl).SetNotifyUrl(a.config.NotifyUrl)
	// 生成單號(hào)
	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 構(gòu)造參數(shù)
	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)
	// 發(fā)起支付
	return a.alipay.TradePagePay(a.ctx, bm)
}

此函數(shù)中，我們將支付的關(guān)鍵參數(shù)（如商品描述、訂單號(hào)、支付金額等）傳遞給支付寶SDK，支付寶返回生成的支付二維碼，用戶(hù)通過(guò)掃碼即可完成支付。

2. 實(shí)現(xiàn)WAP端支付

移動(dòng)端支付（WAP端）與PC端支付類(lèi)似，但需要額外處理 quit_url 參數(shù)，該參數(shù)決定用戶(hù)在支付取消后跳轉(zhuǎn)的地址。

// WapPay WAP端支付
func (a *AlipayService) WapPay(charge *Charge) (string, error) {
	a.alipay = a.alipay.SetReturnUrl(a.config.ReturnUrl).SetNotifyUrl(a.config.NotifyUrl)
	// 生成單號(hào)
	amount := decimal.NewFromInt(charge.MoneyFee).DivRound(decimal.NewFromInt(100), 2).String()
	// 構(gòu)造參數(shù)
	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")
	// 發(fā)起支付
	return a.alipay.TradeWapPay(a.ctx, bm)
}

3. 實(shí)現(xiàn)Android端支付

在Android端，支付寶提供了App支付方式。通過(guò)生成支付參數(shù)，客戶(hù)端可以調(diào)用支付寶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()
	// 構(gòu)造參數(shù)
	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")
	// 發(fā)起支付
	return a.alipay.TradeAppPay(a.ctx, bm)
}

3. 支付結(jié)果回調(diào)

當(dāng)用戶(hù)完成支付后，支付寶會(huì)向您的服務(wù)器發(fā)送支付結(jié)果的通知。您需要解析這些通知并驗(yàn)證其有效性：

// AliWebPayResult 支付寶支付結(jié)果回調(diào)
type AliWebPayResult struct {
	OutTradeNo  string `json:"out_trade_no"`
	TradeStatus string `json:"trade_status"`
}

// GetNotifyResult  解析支付回調(diào)
func (a *AlipayService) GetNotifyResult(r *http.Request) (result *AliWebPayResult, err error) {
	// 解析異步通知的參數(shù)
	notifyReq, err := alipay.ParseNotifyToBodyMap(r)
	if err != nil {
		// TODO 處理錯(cuò)誤信息
		return
	}

	// 支付寶異步通知驗(yàn)簽（公鑰模式）
	_, err = alipay.VerifySign(a.config.PublicKey, notifyReq)
	if err != nil {
		// TODO 處理錯(cuò)誤信息
		return
	}
	if err = notifyReq.Unmarshal(result); err != nil {
		// TODO 處理錯(cuò)誤信息
		return
	}
	return
}

四、退款功能實(shí)現(xiàn)

退款時(shí)序圖

支付寶退款時(shí)序圖

支付寶退款跟微信退款不一樣的，支付寶退款的結(jié)果是接口直接返回的，而不是異步通知的，發(fā)起退款的時(shí)候也不支持回調(diào)通知

發(fā)起退款

退款操作的關(guān)鍵是構(gòu)造正確的退款參數(shù)，并通過(guò)支付寶API發(fā)起退款請(qǐng)求。下面是退款的代碼實(shí)現(xiàn)：

// RefundCharge 退款參數(shù)
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()
	// 構(gòu)造參數(shù)
	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)
	// 發(fā)起支付
	res, err := a.alipay.TradeRefund(a.ctx, bm)
	//TODO 處理錯(cuò)誤信息，處理結(jié)果
	return
}

五、總結(jié)

本文通過(guò)Go語(yǔ)言結(jié)合 go-pay 庫(kù)，詳細(xì)介紹了如何對(duì)接支付寶的PC端支付、WAP端支付、Android端支付以及退款功能。通過(guò)合理的封裝和錯(cuò)誤處理，開(kāi)發(fā)者可以快速集成支付寶支付功能到自己的項(xiàng)目中。希望本文能夠幫助到有支付集成需求的開(kāi)發(fā)者，在實(shí)際開(kāi)發(fā)中提升效率。

更多支付寶API細(xì)節(jié)，請(qǐng)參考支付寶官方文檔。

到此這篇關(guān)于Go語(yǔ)言實(shí)現(xiàn)支付寶支付與退款詳解的文章就介紹到這了,更多相關(guān)Go語(yǔ)言支付寶支付內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: