Golang Stripe支付API集成指南

Stripe是一个流行的支付处理平台，提供了完善的API用于集成支付功能到应用中。下面我将介绍如何在Golang中使用Stripe官方库进行支付集成。

安装Stripe库

首先安装Stripe的Go SDK：

go get github.com/stripe/stripe-go/v72

基本配置

package main

import (
	"log"
	"github.com/stripe/stripe-go/v72"
	"github.com/stripe/stripe-go/v72/client"
)

func main() {
	// 设置Stripe API密钥
	stripe.Key = "sk_test_your_test_secret_key"
	
	// 或者使用客户端模式
	sc := &client.API{}
	sc.Init("sk_test_your_test_secret_key", nil)
}

核心功能实现

1. 创建支付意向(Payment Intent)

func createPaymentIntent(amount int64, currency string) (*stripe.PaymentIntent, error) {
	params := &stripe.PaymentIntentParams{
		Amount:   stripe.Int64(amount),
		Currency: stripe.String(currency),
		// 可选: 设置支付方式类型
		PaymentMethodTypes: stripe.StringSlice([]string{
			"card",
		}),
	}
	
	return paymentintent.New(params)
}

// 使用示例
intent, err := createPaymentIntent(1000, "usd") // 10美元
if err != nil {
	log.Fatal(err)
}
log.Printf("Payment Intent created: %v", intent.ID)

2. 确认支付

func confirmPaymentIntent(paymentIntentID, paymentMethodID string) (*stripe.PaymentIntent, error) {
	params := &stripe.PaymentIntentConfirmParams{
		PaymentMethod: stripe.String(paymentMethodID),
	}
	return paymentintent.Confirm(paymentIntentID, params)
}

3. 创建客户

func createCustomer(email, name string) (*stripe.Customer, error) {
	params := &stripe.CustomerParams{
		Email: stripe.String(email),
		Name:  stripe.String(name),
	}
	return customer.New(params)
}

4. 创建订阅

func createSubscription(customerID, priceID string) (*stripe.Subscription, error) {
	params := &stripe.SubscriptionParams{
		Customer: stripe.String(customerID),
		Items: []*stripe.SubscriptionItemsParams{
			{
				Price: stripe.String(priceID),
			},
		},
	}
	return sub.New(params)
}

5. 处理Webhook事件

func handleWebhook(payload []byte, signature, secret string) (stripe.Event, error) {
	event, err := webhook.ConstructEvent(payload, signature, secret)
	if err != nil {
		return stripe.Event{}, err
	}

	switch event.Type {
	case "payment_intent.succeeded":
		var paymentIntent stripe.PaymentIntent
		err := json.Unmarshal(event.Data.Raw, &paymentIntent)
		if err != nil {
			return stripe.Event{}, err
		}
		log.Printf("Payment succeeded: %v", paymentIntent.ID)
	case "payment_intent.payment_failed":
		var paymentIntent stripe.PaymentIntent
		err := json.Unmarshal(event.Data.Raw, &paymentIntent)
		if err != nil {
			return stripe.Event{}, err
		}
		log.Printf("Payment failed: %v", paymentIntent.ID)
	}

	return event, nil
}

完整示例：创建并确认支付

package main

import (
	"fmt"
	"log"

	"github.com/stripe/stripe-go/v72"
	"github.com/stripe/stripe-go/v72/customer"
	"github.com/stripe/stripe-go/v72/paymentintent"
	"github.com/stripe/stripe-go/v72/paymentmethod"
)

func main() {
	stripe.Key = "sk_test_your_test_secret_key"

	// 1. 创建客户
	customerParams := &stripe.CustomerParams{
		Email: stripe.String("customer@example.com"),
		Name:  stripe.String("John Doe"),
	}
	c, err := customer.New(customerParams)
	if err != nil {
		log.Fatal(err)
	}

	// 2. 创建支付方式(信用卡)
	pmParams := &stripe.PaymentMethodParams{
		Type: stripe.String("card"),
		Card: &stripe.PaymentMethodCardParams{
			Number:   stripe.String("4242424242424242"),
			ExpMonth: stripe.String("12"),
			ExpYear:  stripe.String("2030"),
			CVC:      stripe.String("123"),
		},
	}
	pm, err := paymentmethod.New(pmParams)
	if err != nil {
		log.Fatal(err)
	}

	// 3. 将支付方式附加到客户
	attachParams := &stripe.PaymentMethodAttachParams{
		Customer: stripe.String(c.ID),
	}
	_, err = paymentmethod.Attach(pm.ID, attachParams)
	if err != nil {
		log.Fatal(err)
	}

	// 4. 创建支付意向
	piParams := &stripe.PaymentIntentParams{
		Amount:        stripe.Int64(1000), // $10.00
		Currency:      stripe.String("usd"),
		Customer:      stripe.String(c.ID),
		PaymentMethod: stripe.String(pm.ID),
		Confirm:       stripe.Bool(true),
		OffSession:    stripe.Bool(true),
	}
	pi, err := paymentintent.New(piParams)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Payment Intent created: %v, Status: %v\n", pi.ID, pi.Status)
}

最佳实践

1. 密钥管理：不要将密钥硬编码在代码中，使用环境变量或密钥管理服务
2. 错误处理：正确处理所有可能的API错误
3. 测试：使用Stripe的测试模式和测试卡号进行充分测试
4. 日志记录：记录所有重要的支付事件
5. Webhook验证：始终验证Webhook签名

总结

通过Stripe的Go SDK，我们可以方便地集成支付功能到Golang应用中。本文介绍了支付意向、客户管理、订阅和Webhook处理等核心功能。实际应用中还需要考虑错误处理、重试逻辑和安全措施等更多细节。

Stripe文档非常完善，建议参考官方文档获取最新信息：Stripe官方文档