使用go-pay/gopay处理Apple支付全流程指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00849/article/details/148507874

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

gopay go-pay/gopay 是一个用于集成多种支付方式的 Go 语言包。适合在 Go 语言开发的应用程序中实现支付功能。特点是提供了简洁易用的 API、丰富的支付方式和良好的兼容性。项目地址: https://gitcode.com/gh_mirrors/go/gopay

前言

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

环境准备

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

拥有有效的Apple开发者账号
在App Store Connect中配置了应用内购买项目
获取了必要的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)