快捷導(dǎo)航

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

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

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

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

一、準(zhǔn)備工作

在開始編碼之前，你需要準(zhǔn)備以下幾項：

注冊成為支付寶支付商戶：注冊并登錄支付寶開放平臺，獲取必要的AppID、商戶ID（MchId）、私鑰等信息。

獲取必要的配置信息：

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

安裝第三方庫：安裝GoPay庫，這是一個Go語言的支付寶SDK，可以簡化開發(fā)流程。

go get github.com/go-pay/gopay

二、初始化配置

首先，我們需要定義支付相關(guān)的配置信息，包括應(yīng)用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服務(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 // 開啟debug
    alipayCli.SetCharset(alipay.UTF8).SetSignType(alipay.RSA2)
    
    return &AlipayService{
        ctx:    ctx,
        config: config,
        alipay: alipayCli,
    }
}

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

1. 付款時序圖

支付時序圖

2. 實現(xiàn)不同場景下的支付

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

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

// 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()
	// 構(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ù)（如商品描述、訂單號、支付金額等）傳遞給支付寶SDK，支付寶返回生成的支付二維碼，用戶通過掃碼即可完成支付。

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

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

// 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()
	// 構(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. 實現(xiàn)Android端支付

在Android端，支付寶提供了App支付方式。通過生成支付參數(shù)，客戶端可以調(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)用戶完成支付后，支付寶會向您的服務(wù)器發(fā)送支付結(jié)果的通知。您需要解析這些通知并驗證其有效性：

// 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 處理錯誤信息
		return
	}

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

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

退款時序圖

支付寶退款時序圖

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

發(fā)起退款

退款操作的關(guān)鍵是構(gòu)造正確的退款參數(shù)，并通過支付寶API發(fā)起退款請求。下面是退款的代碼實現(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 處理錯誤信息，處理結(jié)果
	return
}

五、總結(jié)

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

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

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

您可能感興趣的文章: