// File: ymt_v3/go.mod ```go module ymt_v3 go 1.21 ``` // File: ymt_v3/errors.go ```go package ymt_v3 import "fmt" // APIError 表示API返回的错误信息 type APIError struct { Code int32 `json:"code"` Message string `json:"message"` Reason string `json:"reason,omitempty"` } func (e *APIError) Error() string { if e.Reason != "" { return fmt.Sprintf("code=%d, message=%s, reason=%s", e.Code, e.Message, e.Reason) } return fmt.Sprintf("code=%d, message=%s", e.Code, e.Message) } ``` // File: ymt_v3/types.go ```go package ymt_v3 // OrderRequest 获取券码请求(业务明文参数) type OrderRequest struct { OutBizNo string `json:"out_biz_no"` ActivityNo string `json:"activity_no"` Account string `json:"account,omitempty"` NotifyURL string `json:"notify_url,omitempty"` } // OrderResponse 获取券码/券码查询响应(解密后) type OrderResponse struct { OutBizNo string `json:"out_biz_no"` TradeNo string `json:"trade_no"` Key string `json:"key,omitempty"` URL string `json:"url,omitempty"` ValidBeginTime string `json:"valid_begin_time,omitempty"` ValidEndTime string `json:"valid_end_time,omitempty"` UsableNum uint32 `json:"usable_num"` UsageNum uint32 `json:"usage_num"` Status uint32 `json:"status"` SettlementPrice float64 `json:"settlement_price,omitempty"` Account string `json:"account,omitempty"` } // QueryRequest 券码查询请求(业务明文参数) type QueryRequest struct { OutBizNo string `json:"out_biz_no,omitempty"` TradeNo string `json:"trade_no,omitempty"` } // DiscardRequest 券码作废请求(业务明文参数) type DiscardRequest struct { OutBizNo string `json:"out_biz_no,omitempty"` TradeNo string `json:"trade_no,omitempty"` } // DiscardResponse 券码作废响应(解密后) type DiscardResponse struct { OutBizNo string `json:"out_biz_no"` TradeNo string `json:"trade_no"` Status uint32 `json:"status"` } // BatchOrderRequest 批量发卡请求(业务明文参数) type BatchOrderRequest struct { OutBizNo string `json:"out_biz_no"` ActivityNo string `json:"activity_no"` Number int32 `json:"number"` NotifyURL string `json:"notify_url,omitempty"` } // BatchOrderResponse 批量发卡响应(解密后) type BatchOrderResponse struct { OutBizNo string `json:"out_biz_no"` TradeNo string `json:"trade_no"` Status string `json:"status"` } // BatchQueryRequest 批量查询请求(业务明文参数) type BatchQueryRequest struct { OutBizNo string `json:"out_biz_no,omitempty"` TradeNo string `json:"trade_no,omitempty"` } // BatchQueryResponse 批量查询响应(解密后) type BatchQueryResponse struct { OutBizNo string `json:"out_biz_no"` TradeNo string `json:"trade_no"` Status string `json:"status"` DownloadURL string `json:"download_url,omitempty"` ZipPassword string `json:"zip_password,omitempty"` } // EncryptedRequest 公共加密请求体 type EncryptedRequest struct { Ciphertext string `json:"ciphertext"` } // EncryptedResponse 公共加密响应体 type EncryptedResponse struct { Code int32 `json:"code"` Message string `json:"message"` Reason string `json:"reason,omitempty"` Data *EncryptedData `json:"data,omitempty"` } // EncryptedData 加密数据包装 type EncryptedData struct { Ciphertext string `json:"ciphertext"` } ``` // File: ymt_v3/crypto.go ```go package ymt_v3 import ( "bytes" "crypto" "crypto/aes" "crypto/rand" "crypto/rsa" "crypto/sha256" "crypto/x509" "encoding/base64" "encoding/json" "encoding/pem" "fmt" "io" "reflect" "sort" "strings" "time" ) // ============================================================ // 时间戳工具 // ============================================================ // GenerateTimestamp 生成格式为 yyyy-MM-dd HH:mm:ss 的时间戳 func GenerateTimestamp() string { return time.Now().Format("2006-01-02 15:04:05") } // ============================================================ // PKCS7 填充/去填充 // ============================================================ func pkcs7Padding(data []byte, blockSize int) []byte { padding := blockSize - len(data)%blockSize padText := bytes.Repeat([]byte{byte(padding)}, padding) return append(data, padText...) } func pkcs7UnPadding(data []byte) ([]byte, error) { length := len(data) if length == 0 { return nil, fmt.Errorf("数据为空") } padding := int(data[length-1]) if padding > length || padding == 0 { return nil, fmt.Errorf("无效的填充") } for i := length - padding; i < length; i++ { if data[i] != byte(padding) { return nil, fmt.Errorf("无效的填充") } } return data[:length-padding], nil } // ============================================================ // AES-ECB 加密/解密 // ============================================================ // AESECBEncrypt AES-ECB模式加密,返回base64编码 func AESECBEncrypt(plaintext []byte, key []byte) (string, error) { block, err := aes.NewCipher(key) if err != nil { return "", fmt.Errorf("创建AES cipher失败: %v", err) } padded := pkcs7Padding(plaintext, aes.BlockSize) ciphertext := make([]byte, len(padded)) for i := 0; i < len(padded); i += aes.BlockSize { block.Encrypt(ciphertext[i:i+aes.BlockSize], padded[i:i+aes.BlockSize]) } return base64.StdEncoding.EncodeToString(ciphertext), nil } // AESECBDecrypt AES-ECB模式解密,输入base64编码 func AESECBDecrypt(encryptedData string, key []byte) ([]byte, error) { ciphertext, err := base64.StdEncoding.DecodeString(encryptedData) if err != nil { return nil, fmt.Errorf("base64解码失败: %v", err) } block, err := aes.NewCipher(key) if err != nil { return nil, fmt.Errorf("创建AES cipher失败: %v", err) } if len(ciphertext)%aes.BlockSize != 0 { return nil, fmt.Errorf("密文长度不是块大小的整数倍") } plaintext := make([]byte, len(ciphertext)) for i := 0; i < len(ciphertext); i += aes.BlockSize { block.Decrypt(plaintext[i:i+aes.BlockSize], ciphertext[i:i+aes.BlockSize]) } plaintext, err = pkcs7UnPadding(plaintext) if err != nil { return nil, fmt.Errorf("去除填充失败: %v", err) } return plaintext, nil } // ============================================================ // SM4-CBC 加密/解密(纯Go实现,无外部依赖) // ============================================================ // SM4CBCEncrypt SM4-CBC模式加密,返回base64编码(IV前置) func SM4CBCEncrypt(plaintext []byte, key []byte) (string, error) { if len(key) != 16 { return "", fmt.Errorf("SM4密钥长度必须为16字节") } block, err := newSM4Cipher(key) if err != nil { return "", fmt.Errorf("创建SM4 cipher失败: %v", err) } padded := pkcs7Padding(plaintext, block.BlockSize()) iv := make([]byte, block.BlockSize()) if _, err := io.ReadFull(rand.Reader, iv); err != nil { return "", fmt.Errorf("生成IV失败: %v", err) } mode := newCBCEncrypter(block, iv) ciphertext := make([]byte, len(padded)) mode.CryptBlocks(ciphertext, padded) result := append(iv, ciphertext...) return base64.StdEncoding.EncodeToString(result), nil } // SM4CBCDecrypt SM4-CBC模式解密,输入base64编码 func SM4CBCDecrypt(encryptedData string, key []byte) ([]byte, error) { if len(key) != 16 { return nil, fmt.Errorf("SM4密钥长度必须为16字节") } data, err := base64.StdEncoding.DecodeString(encryptedData) if err != nil { return nil, fmt.Errorf("base64解码失败: %v", err) } block, err := newSM4Cipher(key) if err != nil { return nil, fmt.Errorf("创建SM4 cipher失败: %v", err) } blockSize := block.BlockSize() if len(data) < blockSize { return nil, fmt.Errorf("数据长度不足") } iv := data[:blockSize] ciphertext := data[blockSize:] mode := newCBCDecrypter(block, iv) plaintext := make([]byte, len(ciphertext)) mode.CryptBlocks(plaintext, ciphertext) plaintext, err = pkcs7UnPadding(plaintext) if err != nil { return nil, fmt.Errorf("去除填充失败: %v", err) } return plaintext, nil } // ============================================================ // SM4 纯Go实现 // ============================================================ type sm4Cipher struct { sk [32]uint32 } func newSM4Cipher(key []byte) (*sm4Cipher, error) { if len(key) != 16 { return nil, fmt.Errorf("SM4密钥长度必须为16字节") } c := &sm4Cipher{} c.sm4KeyInit(key) return c, nil } func (c *sm4Cipher) BlockSize() int { return 16 } func (c *sm4Cipher) Encrypt(dst, src []byte) { c.sm4OneRound(dst, src, c.sk) } func (c *sm4Cipher) Decrypt(dst, src []byte) { var rk [32]uint32 for i := 0; i < 32; i++ { rk[i] = c.sk[31-i] } c.sm4OneRound(dst, src, rk) } type sm4CBCEncrypter struct { b *sm4Cipher iv []byte } func newCBCEncrypter(b *sm4Cipher, iv []byte) *sm4CBCEncrypter { return &sm4CBCEncrypter{b: b, iv: append([]byte{}, iv...)} } func (c *sm4CBCEncrypter) CryptBlocks(dst, src []byte) { blockSize := c.b.BlockSize() iv := make([]byte, blockSize) copy(iv, c.iv) for i := 0; i < len(src); i += blockSize { for j := 0; j < blockSize; j++ { dst[i+j] = src[i+j] ^ iv[j] } c.b.Encrypt(dst[i:i+blockSize], dst[i:i+blockSize]) copy(iv, dst[i:i+blockSize]) } } type sm4CBCDecrypter struct { b *sm4Cipher iv []byte } func newCBCDecrypter(b *sm4Cipher, iv []byte) *sm4CBCDecrypter { return &sm4CBCDecrypter{b: b, iv: append([]byte{}, iv...)} } func (c *sm4CBCDecrypter) CryptBlocks(dst, src []byte) { blockSize := c.b.BlockSize() iv := make([]byte, blockSize) copy(iv, c.iv) for i := 0; i < len(src); i += blockSize { c.b.Decrypt(dst[i:i+blockSize], src[i:i+blockSize]) for j := 0; j < blockSize; j++ { dst[i+j] ^= iv[j] } copy(iv, src[i:i+blockSize]) } } var sm4Sbox = [256]byte{ 0xd6, 0x90, 0xe9, 0xfe, 0xcc, 0xe1, 0x3d, 0xb7, 0x16, 0xb6, 0x14, 0xc2, 0x28, 0xfb, 0x2c, 0x05, 0x2b, 0x67, 0x9a, 0x76, 0x2a, 0xbe, 0x04, 0xc3, 0xaa, 0x44, 0x13, 0x26, 0x49, 0x86, 0x06, 0x99, 0x9c, 0x42, 0x50, 0xf4, 0x91, 0xef, 0x98, 0x7a, 0x33, 0x54, 0x0b, 0x43, 0xed, 0xcf, 0xac, 0x62, 0xe4, 0xb3, 0x1c, 0xa9, 0xc9, 0x08, 0xe8, 0x95, 0x80, 0xdf, 0x94, 0xfa, 0x75, 0x8f, 0x3f, 0xa6, 0x47, 0x07, 0xa7, 0xfc, 0xf3, 0x73, 0x17, 0xba, 0x83, 0x59, 0x3c, 0x19, 0xe6, 0x85, 0x4f, 0xa8, 0x68, 0x6b, 0x81, 0xb2, 0x71, 0x64, 0xda, 0x8b, 0xf8, 0xeb, 0x0f, 0x4b, 0x70, 0x56, 0x9d, 0x35, 0x1e, 0x24, 0x0e, 0x5e, 0x63, 0x58, 0xd1, 0xa2, 0x25, 0x22, 0x7c, 0x3b, 0x01, 0x21, 0x78, 0x87, 0xd4, 0x00, 0x46, 0x57, 0x9f, 0xd3, 0x27, 0x52, 0x4c, 0x36, 0x02, 0xe7, 0xa0, 0xc4, 0xc8, 0x9e, 0xea, 0xbf, 0x8a, 0xd2, 0x40, 0xc7, 0x38, 0xb5, 0xa3, 0xf7, 0xf2, 0xce, 0xf9, 0x61, 0x15, 0xa1, 0xe0, 0xae, 0x5d, 0xa4, 0x9b, 0x34, 0x1a, 0x55, 0xad, 0x93, 0x32, 0x30, 0xf5, 0x8c, 0xb1, 0xe3, 0x1d, 0xf6, 0xe2, 0x2e, 0x82, 0x66, 0xca, 0x60, 0xc0, 0x29, 0x23, 0xab, 0x0d, 0x53, 0x4e, 0x6f, 0xd5, 0xdb, 0x37, 0x45, 0xde, 0xfd, 0x8e, 0x2f, 0x03, 0xff, 0x6a, 0x72, 0x6d, 0x6c, 0x5b, 0x51, 0x8d, 0x1b, 0xaf, 0x92, 0xbb, 0xdd, 0xbc, 0x7f, 0x11, 0xd9, 0x5c, 0x41, 0x1f, 0x10, 0x5a, 0xd8, 0x0a, 0xc1, 0x31, 0x88, 0xa5, 0xcd, 0x7b, 0xbd, 0x2d, 0x74, 0xd0, 0x12, 0xb8, 0xe5, 0xb4, 0xb0, 0x89, 0x69, 0x97, 0x4a, 0x0c, 0x96, 0x77, 0x7e, 0x65, 0xb9, 0xf1, 0x09, 0xc5, 0x6e, 0xc6, 0x84, 0x18, 0xf0, 0x7d, 0xec, 0x3a, 0xdc, 0x4d, 0x20, 0x79, 0xee, 0x5f, 0x3e, 0xd7, 0xcb, 0x39, 0x48, } var sm4FK = [4]uint32{0xa3b1bac6, 0x56aa3350, 0x677d9197, 0xb27022dc} var sm4CK = [32]uint32{ 0x00070e15, 0x1c232a31, 0x383f464d, 0x545b6269, 0x70777e85, 0x8c939aa1, 0xa8afb6bd, 0xc4cbd2d9, 0xe0e7eef5, 0xfc030a11, 0x181f262d, 0x343b4249, 0x50575e65, 0x6c737a81, 0x888f969d, 0xa4abb2b9, 0xc0c7ced5, 0xdce3eaf1, 0xf8ff060d, 0x141b2229, 0x30373e45, 0x4c535a61, 0x686f767d, 0x848b9299, 0xa0a7aeb5, 0xbcc3cad1, 0xd8dfe6ed, 0xf4fb0209, 0x10171e25, 0x2c333a41, 0x484f565d, 0x646b7279, } func (c *sm4Cipher) sm4KeyInit(key []byte) { var mk [4]uint32 for i := 0; i < 4; i++ { mk[i] = uint32(key[4*i])<<24 | uint32(key[4*i+1])<<16 | uint32(key[4*i+2])<<8 | uint32(key[4*i+3]) } var k [36]uint32 for i := 0; i < 4; i++ { k[i] = mk[i] ^ sm4FK[i] } for i := 0; i < 32; i++ { k[i+4] = k[i] ^ sm4L1(k[i+1]^k[i+2]^k[i+3]^sm4CK[i]) c.sk[i] = k[i+4] } } func (c *sm4Cipher) sm4OneRound(dst, src []byte, sk [32]uint32) { var x [36]uint32 for i := 0; i < 4; i++ { x[i] = uint32(src[4*i])<<24 | uint32(src[4*i+1])<<16 | uint32(src[4*i+2])<<8 | uint32(src[4*i+3]) } for i := 0; i < 32; i++ { x[i+4] = x[i] ^ sm4L2(x[i+1]^x[i+2]^x[i+3]^sk[i]) } for i := 0; i < 4; i++ { dst[4*i] = byte(x[35-i] >> 24) dst[4*i+1] = byte(x[35-i] >> 16) dst[4*i+2] = byte(x[35-i] >> 8) dst[4*i+3] = byte(x[35-i]) } } func sm4L1(b uint32) uint32 { return b ^ sm4Rotl(b, 2) ^ sm4Rotl(b, 10) ^ sm4Rotl(b, 18) ^ sm4Rotl(b, 24) } func sm4L2(b uint32) uint32 { return b ^ sm4Rotl(b, 13) ^ sm4Rotl(b, 23) } func sm4Rotl(x uint32, n uint32) uint32 { return (x << n) | (x >> (32 - n)) } // ============================================================ // RSA 签名与验签 // ============================================================ // SignWithRSA 使用RSA私钥对字符串进行签名,返回base64编码 func SignWithRSA(signStr string, privateKeyPEM string) (string, error) { block, _ := pem.Decode([]byte(privateKeyPEM)) if block == nil { return "", fmt.Errorf("解析PEM私钥失败") } privateKey, err := x509.ParsePKCS8PrivateKey(block.Bytes) if err != nil { privateKey, err = x509.ParsePKCS1PrivateKey(block.Bytes) if err != nil { return "", fmt.Errorf("解析私钥失败: %v", err) } } rsaPrivateKey, ok := privateKey.(*rsa.PrivateKey) if !ok { return "", fmt.Errorf("不是RSA私钥") } h := sha256.New() h.Write([]byte(signStr)) hashed := h.Sum(nil) signature, err := rsa.SignPKCS1v15(rand.Reader, rsaPrivateKey, crypto.SHA256, hashed) if err != nil { return "", fmt.Errorf("签名失败: %v", err) } return base64.StdEncoding.EncodeToString(signature), nil } // VerifyWithRSA 使用RSA公钥验证签名 func VerifyWithRSA(signStr string, sign string, publicKeyPEM string) error { block, _ := pem.Decode([]byte(publicKeyPEM)) if block == nil { return fmt.Errorf("解析PEM公钥失败") } publicKey, err := x509.ParsePKIXPublicKey(block.Bytes) if err != nil { publicKey, err = x509.ParsePKCS1PublicKey(block.Bytes) if err != nil { return fmt.Errorf("解析公钥失败: %v", err) } } rsaPublicKey, ok := publicKey.(*rsa.PublicKey) if !ok { return fmt.Errorf("不是RSA公钥") } signBytes, err := base64.StdEncoding.DecodeString(sign) if err != nil { return fmt.Errorf("base64解码签名失败: %v", err) } h := sha256.New() h.Write([]byte(signStr)) hashed := h.Sum(nil) return rsa.VerifyPKCS1v15(rsaPublicKey, crypto.SHA256, hashed, signBytes) } // ============================================================ // 业务参数加密/解密 // ============================================================ // EncryptBizParams 加密业务参数 // 将业务参数去掉零值,按字母排序,转JSON,然后用指定算法加密 func EncryptBizParams(params interface{}, key []byte, encryptType string) (string, error) { // 将结构体转为map,去掉零值 m, err := structToMap(params) if err != nil { return "", fmt.Errorf("转换参数失败: %v", err) } // 按key排序 keys := make([]string, 0, len(m)) for k := range m { keys = append(keys, k) } sort.Strings(keys) // 构建有序map orderedMap := make(map[string]interface{}) for _, k := range keys { orderedMap[k] = m[k] } // 转JSON plaintext, err := json.Marshal(orderedMap) if err != nil { return "", fmt.Errorf("JSON序列化失败: %v", err) } // 加密 switch encryptType { case "aes": return AESECBEncrypt(plaintext, key) case "sm4": return SM4CBCEncrypt(plaintext, key) default: return "", fmt.Errorf("不支持的加密类型: %s", encryptType) } } // DecryptBizParams 解密业务参数 func DecryptBizParams(ciphertext string, key []byte, encryptType string) ([]byte, error) { switch encryptType { case "aes": return AESECBDecrypt(ciphertext, key) case "sm4": return SM4CBCDecrypt(ciphertext, key) default: return nil, fmt.Errorf("不支持的加密类型: %s", encryptType) } } // structToMap 将结构体转为map,去掉零值 func structToMap(obj interface{}) (map[string]interface{}, error) { result := make(map[string]interface{}) v := reflect.ValueOf(obj) if v.Kind() == reflect.Ptr { v = v.Elem() } if v.Kind() != reflect.Struct { return nil, fmt.Errorf("不是结构体") } t := v.Type() for i := 0; i < t.NumField(); i++ { field := t.Field(i) value := v.Field(i) // 获取json tag jsonTag := field.Tag.Get("json") if jsonTag == "" || jsonTag == "-" { continue } name := strings.Split(jsonTag, ",")[0] // 检查omitempty opts := strings.Split(jsonTag, ",") omitempty := false for _, opt := range opts[1:] { if opt == "omitempty" { omitempty = true break } } // 获取实际值 var val interface{} switch value.Kind() { case reflect.String: val = value.String() case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: val = value.Int() case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64: val = value.Uint() case reflect.Float32, reflect.Float64: val = value.Float() case reflect.Bool: val = value.Bool() case reflect.Slice, reflect.Map: if value.IsNil() { if omitempty { continue } val = value.Interface() } else { val = value.Interface() } case reflect.Ptr, reflect.Interface: if value.IsNil() { if omitempty { continue } val = nil } else { val = value.Elem().Interface() } default: val = value.Interface() } // 检查零值 if omitempty && isZeroValue(val) { continue } result[name] = val } return result, nil } // isZeroValue 判断值是否为零值 func isZeroValue(v interface{}) bool { if v == nil { return true } rv := reflect.ValueOf(v) switch rv.Kind() { case reflect.String: return rv.String() == "" case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64: return rv.Int() == 0 case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64: return rv.Uint() == 0 case reflect.Float32, reflect.Float64: return rv.Float() == 0 case reflect.Bool: return !rv.Bool() default: return false } } ``` // File: ymt_v3/client.go ```go package ymt_v3 import ( "bytes" "context" "encoding/json" "fmt" "io" "net/http" "sort" "strings" ) // Config 客户端配置 type Config struct { AppID string // 应用ID PrivateKey string // 应用私钥(PEM格式),用于请求签名 PublicKey string // 平台公钥(PEM格式),用于响应验签 Key string // 业务参数加密密钥 EncryptType string // 加密类型:aes 或 sm4 BaseURL string // 接口地址 HTTPClient *http.Client } // Client SDK客户端 type Client struct { config *Config client *http.Client } // NewClient 创建新的SDK客户端 func NewClient(config *Config) *Client { if config.HTTPClient == nil { config.HTTPClient = http.DefaultClient } return &Client{ config: config, client: config.HTTPClient, } } // doRequest 发送请求并处理响应 func (c *Client) doRequest(ctx context.Context, path string, bizParams interface{}, result interface{}) error { // 1. 加密业务参数 ciphertext, err := EncryptBizParams(bizParams, []byte(c.config.Key), c.config.EncryptType) if err != nil { return fmt.Errorf("加密业务参数失败: %v", err) } // 2. 生成时间戳 timestamp := GenerateTimestamp() // 3. 拼接签名字符串:app_id + timestamp + ciphertext signStr := c.config.AppID + timestamp + ciphertext // 4. 使用应用私钥签名 sign, err := SignWithRSA(signStr, c.config.PrivateKey) if err != nil { return fmt.Errorf("签名失败: %v", err) } // 5. 构建请求体 reqBody := EncryptedRequest{ Ciphertext: ciphertext, } bodyBytes, err := json.Marshal(reqBody) if err != nil { return fmt.Errorf("序列化请求体失败: %v", err) } // 6. 创建HTTP请求 url := strings.TrimRight(c.config.BaseURL, "/") + path req, err := http.NewRequestWithContext(ctx, "POST", url, bytes.NewReader(bodyBytes)) if err != nil { return fmt.Errorf("创建请求失败: %v", err) } // 7. 设置Header req.Header.Set("Content-Type", "application/json") req.Header.Set("Appid", c.config.AppID) req.Header.Set("Timestamp", timestamp) req.Header.Set("Sign", sign) // 8. 发送请求 resp, err := c.client.Do(req) if err != nil { return fmt.Errorf("发送请求失败: %v", err) } defer resp.Body.Close() respBody, err := io.ReadAll(resp.Body) if err != nil { return fmt.Errorf("读取响应失败: %v", err) } // 9. 解析响应 var encryptedResp EncryptedResponse if err := json.Unmarshal(respBody, &encryptedResp); err != nil { return fmt.Errorf("解析响应失败: %v", err) } // 10. 检查错误码 if encryptedResp.Code != 200 { return &APIError{ Code: encryptedResp.Code, Message: encryptedResp.Message, Reason: encryptedResp.Reason, } } // 11. 解密响应数据 if encryptedResp.Data == nil || encryptedResp.Data.Ciphertext == "" { return fmt.Errorf("响应数据为空") } plaintext, err := DecryptBizParams(encryptedResp.Data.Ciphertext, []byte(c.config.Key), c.config.EncryptType) if err != nil { return fmt.Errorf("解密响应数据失败: %v", err) } // 12. 解析解密后的数据到结果结构体 if err := json.Unmarshal(plaintext, result); err != nil { return fmt.Errorf("解析解密数据失败: %v", err) } return nil } // ============================================================ // API 方法 // ============================================================ // Order 获取券码 func (c *Client) Order(ctx context.Context, req *OrderRequest) (*OrderResponse, error) { result := &OrderResponse{} if err := c.doRequest(ctx, "/openapi/v1/key/order", req, result); err != nil { return nil, err } return result, nil } // Query 券码查询 func (c *Client) Query(ctx context.Context, req *QueryRequest) (*OrderResponse, error) { result := &OrderResponse{} if err := c.doRequest(ctx, "/openapi/v1/key/query", req, result); err != nil { return nil, err } return result, nil } // Discard 券码作废 func (c *Client) Discard(ctx context.Context, req *DiscardRequest) (*DiscardResponse, error) { result := &DiscardResponse{} if err := c.doRequest(ctx, "/openapi/v1/key/discard", req, result); err != nil { return nil, err } return result, nil } // BatchOrder 批量发卡 func (c *Client) BatchOrder(ctx context.Context, req *BatchOrderRequest) (*BatchOrderResponse, error) { result := &BatchOrderResponse{} if err := c.doRequest(ctx, "/openapi/v1/key/batch_order", req, result); err != nil { return nil, err } return result, nil } // BatchQuery 批量查询 func (c *Client) BatchQuery(ctx context.Context, req *BatchQueryRequest) (*BatchQueryResponse, error) { result := &BatchQueryResponse{} if err := c.doRequest(ctx, "/openapi/v1/key/batch_query", req, result); err != nil { return nil, err } return result, nil } // ============================================================ // 回调验签 // ============================================================ // VerifyCallback 验证回调通知的签名 // 参数: // - appID: 应用ID // - timestamp: 回调请求中的时间戳 // - sign: 回调请求中的签名 // - data: 回调请求中的业务数据(明文JSON字符串) // - publicKeyPEM: 平台公钥(PEM格式) // - key: 业务参数加密密钥 // - encryptType: 加密类型:aes 或 sm4 func VerifyCallback(appID, timestamp, sign, data, publicKeyPEM string, key []byte, encryptType string) error { // 1. 使用key将data加密得到ciphertext ciphertext, err := EncryptBizParamsFromJSON(data, key, encryptType) if err != nil { return fmt.Errorf("加密回调数据失败: %v", err) } // 2. 拼接签名字符串:app_id + timestamp + ciphertext signStr := appID + timestamp + ciphertext // 3. 使用平台公钥验签 return VerifyWithRSA(signStr, sign, publicKeyPEM) } // EncryptBizParamsFromJSON 将JSON字符串按规则加密 func EncryptBizParamsFromJSON(jsonStr string, key []byte, encryptType string) (string, error) { // 解析JSON var data map[string]interface{} if err := json.Unmarshal([]byte(jsonStr), &data); err != nil { return "", fmt.Errorf("解析JSON失败: %v", err) } // 去掉零值 cleaned := make(map[string]interface{}) for k, v := range data { if !isZeroValue(v) { cleaned[k] = v } } // 按key排序 keys := make([]string, 0, len(cleaned)) for k := range cleaned { keys = append(keys, k) } sort.Strings(keys) // 构建有序map orderedMap := make(map[string]interface{}) for _, k := range keys { orderedMap[k] = cleaned[k] } // 转JSON plaintext, err := json.Marshal(orderedMap) if err != nil { return "", fmt.Errorf("JSON序列化失败: %v", err) } // 加密 switch encryptType { case "aes": return AESECBEncrypt(plaintext, key) case "sm4": return SM4CBCEncrypt(plaintext, key) default: return "", fmt.Errorf("不支持的加密类型: %s", encryptType) } } ``` // File: ymt_v3/example_test.go ```go package ymt_v3 import ( "context" "fmt" "testing" ) // 测试参数(请替换为实际值) const ( testAppID = "xxx" testPrivateKey = `-----BEGIN PRIVATE KEY----- xxx -----END PRIVATE KEY-----` testPublicKey = `-----BEGIN PUBLIC KEY----- xxx -----END PUBLIC KEY-----` testKey = "xxxx" testEncryptType = "aes" testBaseURL = "https://gateway.dev.cdlsxd.cn" testActivityNo = "xxxx" ) func TestClient_Order(t *testing.T) { client := NewClient(&Config{ AppID: testAppID, PrivateKey: testPrivateKey, PublicKey: testPublicKey, Key: testKey, EncryptType: testEncryptType, BaseURL: testBaseURL, }) resp, err := client.Order(context.Background(), &OrderRequest{ OutBizNo: "order_001", ActivityNo: testActivityNo, Account: "18666666666", NotifyURL: "https://notify.example.com/openapi", }) if err != nil { t.Fatalf("Order failed: %v", err) } fmt.Printf("Order response: %+v\n", resp) } func TestClient_Query(t *testing.T) { client := NewClient(&Config{ AppID: testAppID, PrivateKey: testPrivateKey, PublicKey: testPublicKey, Key: testKey, EncryptType: testEncryptType, BaseURL: testBaseURL, }) resp, err := client.Query(context.Background(), &QueryRequest{ OutBizNo: "order_001", }) if err != nil { t.Fatalf("Query failed: %v", err) } fmt.Printf("Query response: %+v\n", resp) } func TestClient_Discard(t *testing.T) { client := NewClient(&Config{ AppID: testAppID, PrivateKey: testPrivateKey, PublicKey: testPublicKey, Key: testKey, EncryptType: testEncryptType, BaseURL: testBaseURL, }) resp, err := client.Discard(context.Background(), &DiscardRequest{ TradeNo: "7251449503000383488", }) if err != nil { t.Fatalf("Discard failed: %v", err) } fmt.Printf("Discard response: %+v\n", resp) } func TestClient_BatchOrder(t *testing.T) { client := NewClient(&Config{ AppID: testAppID, PrivateKey: testPrivateKey, PublicKey: testPublicKey, Key: testKey, EncryptType: testEncryptType, BaseURL: testBaseURL, }) resp, err := client.BatchOrder(context.Background(), &BatchOrderRequest{ OutBizNo: "batch_001", ActivityNo: testActivityNo, Number: 10, NotifyURL: "https://notify.example.com/openapi", }) if err != nil { t.Fatalf("BatchOrder failed: %v", err) } fmt.Printf("BatchOrder response: %+v\n", resp) } func TestClient_BatchQuery(t *testing.T) { client := NewClient(&Config{ AppID: testAppID, PrivateKey: testPrivateKey, PublicKey: testPublicKey, Key: testKey, EncryptType: testEncryptType, BaseURL: testBaseURL, }) resp, err := client.BatchQuery(context.Background(), &BatchQueryRequest{ TradeNo: "7251449503000383499", }) if err != nil { t.Fatalf("BatchQuery failed: %v", err) } fmt.Printf("BatchQuery response: %+v\n", resp) } func TestVerifyCallback(t *testing.T) { // 模拟回调参数 appID := "123456" timestamp := "2026-06-22 15:30:00" sign := "base64_encoded_signature" data := `{"out_biz_no":"batch_001","trade_no":"7251449503000383499","status":"success","download_url":"https://oss.example.com/openapi_7251449503000383499.zip","zip_password":"123456"}` err := VerifyCallback(appID, timestamp, sign, data, testPublicKey, []byte(testKey), testEncryptType) if err != nil { t.Logf("VerifyCallback result: %v (expected if sign is invalid)", err) } else { t.Log("VerifyCallback success") } } ```