使用payme库生成SEPA支付二维码

SEPA (Single Euro Payments Area) 是欧洲范围内的支付系统标准。在Go语言中，我们可以使用payme库来生成SEPA支付二维码，包括ASCII和PNG格式。下面我将详细介绍如何使用这个库。

安装payme库

首先需要安装payme库：

go get github.com/boombuler/barcode
go get github.com/boombuler/barcode/qr
go get github.com/makiuchi-d/payme

基本用法

1. 生成SEPA支付数据

package main

import (
	"fmt"
	"github.com/makiuchi-d/payme"
)

func main() {
	// 创建SEPA支付信息
	sepa := &payme.SEPA{
		Name:      "John Doe",          // 收款人姓名
		IBAN:      "DE89370400440532013000", // IBAN账号
		BIC:       "DEUTDEBBXXX",       // BIC/SWIFT代码
		Amount:    123.45,              // 金额
		Remittance: "Invoice 12345",    // 备注信息
		Version:   "002",               // SEPA版本
		Charset:   "1",                 // 字符集 (1=UTF-8)
		Identification: "INV12345",     // 交易标识
	}
	
	// 生成SEPA支付字符串
	paymentStr := sepa.String()
	fmt.Println("SEPA Payment String:", paymentStr)
}

2. 生成ASCII二维码

func generateASCIIQR(paymentStr string) {
	qrCode, err := payme.NewQRCode(paymentStr)
	if err != nil {
		fmt.Println("Error generating QR code:", err)
		return
	}
	
	// 生成ASCII二维码
	ascii := qrCode.ToASCII(false)
	fmt.Println("ASCII QR Code:")
	fmt.Println(ascii)
}

3. 生成PNG格式二维码

import (
	"image/png"
	"os"
)

func generatePNGQR(paymentStr string, filename string) {
	qrCode, err := payme.NewQRCode(paymentStr)
	if err != nil {
		fmt.Println("Error generating QR code:", err)
		return
	}
	
	// 生成PNG图像
	img := qrCode.Image(256) // 256是图像大小(像素)
	
	// 保存到文件
	file, err := os.Create(filename)
	if err != nil {
		fmt.Println("Error creating file:", err)
		return
	}
	defer file.Close()
	
	err = png.Encode(file, img)
	if err != nil {
		fmt.Println("Error encoding PNG:", err)
		return
	}
	
	fmt.Println("PNG QR code saved to", filename)
}

完整示例

package main

import (
	"fmt"
	"image/png"
	"os"
	
	"github.com/makiuchi-d/payme"
)

func main() {
	// 1. 创建SEPA支付信息
	sepa := &payme.SEPA{
		Name:      "John Doe",
		IBAN:      "DE89370400440532013000",
		BIC:       "DEUTDEBBXXX",
		Amount:    123.45,
		Remittance: "Invoice 12345",
		Version:   "002",
		Charset:   "1",
		Identification: "INV12345",
	}
	
	// 2. 生成支付字符串
	paymentStr := sepa.String()
	fmt.Println("SEPA Payment String:", paymentStr)
	
	// 3. 生成ASCII二维码
	generateASCIIQR(paymentStr)
	
	// 4. 生成PNG二维码
	generatePNGQR(paymentStr, "sepa_payment.png")
}

func generateASCIIQR(paymentStr string) {
	qrCode, err := payme.NewQRCode(paymentStr)
	if err != nil {
		fmt.Println("Error generating QR code:", err)
		return
	}
	
	ascii := qrCode.ToASCII(false)
	fmt.Println("\nASCII QR Code:")
	fmt.Println(ascii)
}

func generatePNGQR(paymentStr string, filename string) {
	qrCode, err := payme.NewQRCode(paymentStr)
	if err != nil {
		fmt.Println("Error generating QR code:", err)
		return
	}
	
	img := qrCode.Image(256)
	
	file, err := os.Create(filename)
	if err != nil {
		fmt.Println("Error creating file:", err)
		return
	}
	defer file.Close()
	
	err = png.Encode(file, img)
	if err != nil {
		fmt.Println("Error encoding PNG:", err)
		return
	}
	
	fmt.Println("\nPNG QR code saved to", filename)
}

高级选项

自定义二维码大小和边距

// 创建自定义二维码
qrCode, err := payme.NewQRCodeWithOptions(paymentStr, &payme.QRCodeOptions{
	Size:   300,       // 二维码大小(像素)
	Margin: 10,        // 边距大小
	Level:  qr.M,      // 纠错级别 (L, M, Q, H)
})

验证IBAN和BIC

// 验证IBAN
if !payme.ValidateIBAN(sepa.IBAN) {
	fmt.Println("Invalid IBAN")
}

// 验证BIC
if !payme.ValidateBIC(sepa.BIC) {
	fmt.Println("Invalid BIC")
}

注意事项

1. SEPA支付字符串有长度限制(最多331个字符)
2. 确保所有必填字段都已设置
3. 金额格式应为欧元，小数点后最多两位
4. 对于生产环境，建议添加更多的错误处理

这个payme库提供了简单易用的接口来生成符合SEPA标准的支付二维码，适用于各种欧洲支付场景。