使用go-pay/gopay处理Apple支付全流程指南

前言

在移动应用开发中，Apple支付是iOS生态中不可或缺的一部分。go-pay/gopay项目提供了完整的Apple支付处理方案，帮助开发者轻松实现支付验证、通知处理等功能。本文将详细介绍如何使用go-pay/gopay处理Apple支付全流程。

环境准备

在开始之前，请确保你已经：

1. 拥有有效的Apple开发者账号
2. 在App Store Connect中配置了应用内购买项目
3. 获取了必要的API密钥和证书

初始化Apple客户端

go-pay/gopay提供了简洁的Apple客户端初始化方式：

import (
    "github.com/go-pay/xlog"
    "github.com/go-pay/gopay/apple"
)

// 参数说明：
// iss - issuer ID（发行者ID）
// bid - bundle ID（应用包名）
// kid - private key ID（密钥ID）
// secretKey - 密钥文件内容字符串
// isProd - 是否生产环境（true为生产环境，false为沙箱环境）
client, err := apple.NewClient(iss, bid, kid, "secretKey", false)
if err != nil {
    xlog.Error("初始化Apple客户端失败:", err)
    return
}

支付凭证验证

Apple支付完成后，应用会收到一个支付凭证（receipt），需要在服务端进行验证：

import (
    "github.com/go-pay/gopay/apple"
    "github.com/go-pay/xlog"
)

// 参数说明：
// apple.UrlSandbox - 沙箱环境验证地址
// apple.UrlProd - 生产环境验证地址
// pwd - 共享密钥（可选）
// receipt - 支付凭证字符串
rsp, err := apple.VerifyReceipt(apple.UrlSandbox, pwd, receipt)
if err != nil {
    xlog.Error("验证支付凭证失败:", err)
    return
}

// 处理验证结果
if rsp.Receipt != nil {
    xlog.Infof("验证成功，凭证信息:%+v", rsp.Receipt)
    // 这里可以处理业务逻辑，如记录订单、发放商品等
}

验证返回的凭证信息包含以下关键字段：

• transaction_id: 交易ID
• product_id: 商品ID
• purchase_date: 购买日期
• original_transaction_id: 原始交易ID（续订时使用）
• is_trial_period: 是否为试用期

处理服务器通知（V2版本）

Apple会通过服务器通知（App Store Server Notifications）告知支付状态变更。go-pay/gopay提供了完整的通知处理方案：

1. 解析通知数据

import (
    "github.com/go-pay/gopay/apple"
    "github.com/go-pay/xlog"
)

// 解析签名后的通知数据
payload, err := apple.DecodeSignedPayload(signedPayload)
if err != nil {
    xlog.Error("解析通知数据失败:", err)
    return
}

// 打印通知基本信息
xlog.Debugf("通知类型: %s", payload.NotificationType)
xlog.Debugf("子类型: %s", payload.Subtype)
xlog.Debugf("通知UUID: %s", payload.NotificationUUID)

2. 解析续订信息

// 解析续订信息
renewalInfo, err := payload.DecodeRenewalInfo()
if err != nil {
    xlog.Error("解析续订信息失败:", err)
    return
}

// 打印续订信息
xlog.Debugf("自动续订产品ID: %s", renewalInfo.AutoRenewProductId)
xlog.Debugf("自动续订状态: %d", renewalInfo.AutoRenewStatus)
xlog.Debugf("原始交易ID: %s", renewalInfo.OriginalTransactionId)

3. 解析交易信息

// 解析交易信息
transactionInfo, err := payload.DecodeTransactionInfo()
if err != nil {
    xlog.Error("解析交易信息失败:", err)
    return
}

// 打印交易信息
xlog.Debugf("产品ID: %s", transactionInfo.ProductId)
xlog.Debugf("购买日期: %d", transactionInfo.PurchaseDate)
xlog.Debugf("过期日期: %d", transactionInfo.ExpiresDate)

App Store Server API 功能

go-pay/gopay还封装了App Store Server API的常用功能：

1. 获取交易信息

transactionId := "1000000859439868"
transaction, err := client.GetTransactionInfo(transactionId)
if err != nil {
    xlog.Error("获取交易信息失败:", err)
    return
}
xlog.Infof("交易信息: %+v", transaction)

2. 获取交易历史

history, err := client.GetTransactionHistory(originalTransactionId, "", "", 0)
if err != nil {
    xlog.Error("获取交易历史失败:", err)
    return
}
xlog.Infof("交易历史: %+v", history)

3. 获取订阅状态

statuses, err := client.GetAllSubscriptionStatuses(originalTransactionId)
if err != nil {
    xlog.Error("获取订阅状态失败:", err)
    return
}
xlog.Infof("订阅状态: %+v", statuses)

最佳实践

1. 环境区分：开发时使用沙箱环境，上线前切换为生产环境
2. 错误处理：对所有API调用进行错误处理
3. 日志记录：记录完整的请求和响应信息，便于排查问题
4. 幂等处理：处理通知时要考虑重复通知的情况
5. 数据验证：验证所有关键字段，防止伪造请求

常见问题

1. 验证失败：检查环境设置是否正确（沙箱/生产）、证书是否有效
2. 通知解析错误：确认通知版本是否为V2，签名是否正确
3. 续订状态异常：检查自动续订设置和用户订阅状态
4. 时间戳处理：注意Apple返回的时间戳单位（毫秒）

结语

go-pay/gopay为Apple支付提供了完整的解决方案，从客户端初始化到支付验证，再到服务器通知处理，覆盖了Apple支付全流程。通过本文的介绍，相信你已经掌握了使用go-pay/gopay处理Apple支付的关键技术点。在实际应用中，建议结合业务需求进行适当的调整和扩展。