使用Sleet统一多支付服务提供商接口

Sleet是一个Golang库，用于统一不同支付服务提供商的接口，简化在线支付处理。它提供了标准化的API来处理支付、退款等操作，支持多种支付网关如Stripe、Braintree、Adyen等。

安装Sleet

go get github.com/BoltApp/sleet

基本使用

1. 初始化客户端

package main

import (
	"github.com/BoltApp/sleet"
	"github.com/BoltApp/sleet/gateways/adyen"
	stripe "github.com/BoltApp/sleet/gateways/stripe"
)

func main() {
	// 初始化Stripe客户端
	stripeKey := "your_stripe_api_key"
	stripeClient := stripe.NewClient(stripeKey)

	// 初始化Adyen客户端
	adyenClient := adyen.NewClient(
		"your_adyen_api_key",
		"your_merchant_account",
		sleet.EnvironmentSandbox,
	)
	
	// 其他支付网关类似...
}

2. 创建支付请求

amount := sleet.Amount{
	Amount:   1000, // 10.00美元(以分为单位)
	Currency: "USD",
}

address := &sleet.Address{
	StreetAddress1: "123 Main St",
	StreetAddress2: "",
	Locality:       "San Francisco",
	RegionCode:     "CA",
	PostalCode:     "94105",
	CountryCode:    "US",
}

creditCard := sleet.CreditCard{
	FirstName:       "John",
	LastName:        "Doe",
	Number:          "4111111111111111",
	ExpirationMonth: 12,
	ExpirationYear:  2025,
	CVV:            "123",
	BillingAddress:  address,
}

request := sleet.AuthorizationRequest{
	Amount:               amount,
	CreditCard:           creditCard,
	BillingAddress:       address,
	Channel:              "Web",
	MerchantOrderReference: "order_123",
}

3. 处理支付授权

// 使用Stripe处理支付
auth, err := stripeClient.Authorize(&request)
if err != nil {
	// 处理错误
}

// 或者使用Adyen处理支付
auth, err := adyenClient.Authorize(&request)
if err != nil {
	// 处理错误
}

if auth.Success {
	// 支付授权成功
	fmt.Printf("Authorization successful. Transaction ID: %s\n", auth.TransactionReference)
} else {
	// 支付授权失败
	fmt.Printf("Authorization failed. Error: %s\n", auth.ErrorCode)
}

4. 捕获支付

captureRequest := sleet.CaptureRequest{
	Amount:               &amount, // 可选，如果为空则捕获全部金额
	TransactionReference: auth.TransactionReference,
}

captureResponse, err := stripeClient.Capture(&captureRequest)
if err != nil {
	// 处理错误
}

if captureResponse.Success {
	// 捕获成功
}

5. 处理退款

refundRequest := sleet.RefundRequest{
	Amount:               &amount, // 可选，如果为空则退款全部金额
	TransactionReference: auth.TransactionReference,
	MerchantOrderReference: "refund_order_123",
}

refundResponse, err := stripeClient.Refund(&refundRequest)
if err != nil {
	// 处理错误
}

if refundResponse.Success {
	// 退款成功
}

高级功能

1. 支持多种支付网关

// 定义支付网关接口
type PaymentProcessor interface {
	Authorize(*sleet.AuthorizationRequest) (*sleet.AuthorizationResponse, error)
	Capture(*sleet.CaptureRequest) (*sleet.CaptureResponse, error)
	Refund(*sleet.RefundRequest) (*sleet.RefundResponse, error)
	Void(*sleet.VoidRequest) (*sleet.VoidResponse, error)
}

// 根据配置选择支付网关
func GetPaymentProcessor(gateway string, config map[string]string) PaymentProcessor {
	switch gateway {
	case "stripe":
		return stripe.NewClient(config["api_key"])
	case "adyen":
		return adyen.NewClient(config["api_key"], config["merchant_account"], sleet.EnvironmentSandbox)
	// 其他网关...
	default:
		panic("unsupported payment gateway")
	}
}

2. 处理3D Secure支付

// 在授权请求中启用3D Secure
request := sleet.AuthorizationRequest{
	Amount:               amount,
	CreditCard:           creditCard,
	BillingAddress:       address,
	Channel:              "Web",
	MerchantOrderReference: "order_123",
	ThreeDS: &sleet.ThreeDS{
		Required:       true,
		BrowserInfo:    getBrowserInfo(), // 需要提供浏览器信息
		MethodComplete: false,
	},
}

auth, err := client.Authorize(&request)
if err != nil {
	// 处理错误
}

if auth.ThreeDS != nil && auth.ThreeDS.MethodURL != "" {
	// 需要完成3D Secure认证
	// 重定向用户到MethodURL进行认证
}

// 认证完成后，再次提交授权
request.ThreeDS.MethodComplete = true
auth, err = client.Authorize(&request)

3. 处理webhook

// 验证webhook签名
func handleWebhook(w http.ResponseWriter, r *http.Request) {
	body, err := io.ReadAll(r.Body)
	if err != nil {
		http.Error(w, err.Error(), http.StatusBadRequest)
		return
	}

	// 验证签名(以Stripe为例)
	event, err := webhook.ConstructEvent(body, r.Header.Get("Stripe-Signature"), stripeWebhookSecret)
	if err != nil {
		http.Error(w, err.Error(), http.StatusBadRequest)
		return
	}

	switch event.Type {
	case "payment_intent.succeeded":
		// 处理支付成功事件
	case "charge.refunded":
		// 处理退款事件
	// 其他事件...
	}
}

最佳实践

1. 错误处理：始终检查错误并适当处理
2. 日志记录：记录所有支付操作和响应
3. 重试机制：对于暂时性错误实现重试逻辑
4. 测试：使用各支付网关的沙箱环境进行充分测试
5. 监控：监控支付成功率、失败率和响应时间

Sleet通过统一接口简化了多支付网关的集成，使开发者可以更专注于业务逻辑而不是支付网关的差异。