Skip to main content
本页记录 Waffo SDK 包（Node.js / Java / Go / Python）的版本发布。查找 Waffo API 的版本历史，请见 API 版本历史。

​
Node.js SDK (@waffo/waffo-node)

1

v3.0.1 (2026-08-04) — 最新

  • X-SDK-VERSION 请求头更新为 waffo-node/3.0.1
  • merchantConfig().inquiry() 和 payMethodConfig().inquiry() 的 merchantId 改为可选；未传时使用 Waffo client 配置的 merchantId
2

v3.0.0 (2026-07-29)

  • 破坏性变更：CreateOrderParams.paymentTokenData 和 InquiryMerchantConfigData.totalDailyLimit / remainingDailyLimit / transactionLimit 改为 string，与 API 合同中的 JSON-string 字段一致；如需结构化值，请在业务代码中自行解析
  • 移除仅用于旧对象类型的 PaymentTokenData interface
  • Schema 校验现在会对比 OpenAPI 字段类型，而不只对比字段名
3

v2.7.0 (2026-07-28)

  • PayMethodDetail 新增 payMethodType、currency、orderAmountMin、orderAmountMax 和 refundAllowed
  • currentStatus 在实时可用性暂不可用时可为空
4

v2.6.0 (2026-07-17)

  • 新增 Wallet 地址查询、x402 订单数据、promotion 字段和类型化 x402 支付 Webhook 数据
  • 保留已废弃的旧订单和订阅字段/类型，同时让当前 wire contract 与最新 OpenAPI specification 对齐
  • 发布校验会在 shared schema field vector 过期时失败
5

v2.5.1 (2026-07-06)

  • 兼容性修复：subscription().create() 省略 subscriptionManagementUrl 时保持向后兼容
  • subscriptionManagementUrl 字段仍受支持，但 SDK 不会在发送 API 调用前拒绝既有请求
6

v2.5.0 (2026-05-13)

  • 新增 subscription().update()，支持更新订阅金额、试用期金额和计划金额
  • ProductInfo 新增 scheduledAmounts，支持订阅创建、变更、更新和查询中的计划金额
  • 新增订阅扩展信息、Token 卡信息、卡 BIN 和商品详情等类型化字段
  • Order().Capture() 未传 captureRequestedAt 时自动注入当前时间
7

v2.4.0 (2026-03-14)

  • 类型对齐：所有 SDK 类型字段与 openapi.json 定义保持一致
  • 修复 merchantConfig 和 payMethodConfig 的接口路径
  • 为 CaptureOrderParams 添加 captureRequestedAt 字段
  • 为 PaymentInfo 添加 captureMode 字段
  • 添加 Capture 端到端（E2E）测试与 Schema 字段校验测试
8

v2.3.4 (2026-03-10)

  • 将 RefundOrderParams.requestedAt 设为可选；SDK 将自动注入当前 UTC 时间
9

v2.3.3 (2026-03-03)

  • 修复 RefundOrderParams 字段名与类型，使其与 openapi.json 对齐
  • 将 notifyUrl 重命名为 refundNotifyUrl
  • 添加退款 Webhook 端到端（E2E）测试
10

v2.3.2 (2026-03-02)

  • 增加对 SUBSCRIPTION_CHANGE_NOTIFICATION Webhook 事件的处理
11

v2.3.1 (2026-03-01)

  • 重要修复：buildSuccessResponse() 返回 {"message":"success"}，不再返回 {"status":"success"}
12

v2.3.0 (2026-02-24)

  • 自动注入时间戳：未提供时，orderRequestedAt 与 requestedAt 将自动设置

​
Java SDK (waffo-java)

1

v3.0.0 (2026-07-29) — 最新

  • 破坏性变更：CreateOrderParams.paymentTokenData、PaymentInfo.payMethodProperties、PaymentInfo.cashierAppearance 以及 InquiryMerchantConfigData.totalDailyLimit / remainingDailyLimit / transactionLimit 改为 String，与 API 合同中的 JSON-string 字段一致
  • 移除仅用于旧对象类型的 PaymentTokenData、PayMethodProperties 和 CashierAppearance 类；SubscriptionPaymentInfo 中的对应字段已是 String
  • Schema 校验现在会对比 OpenAPI 字段类型；enum 按字符串处理，失败原因字段的自定义反序列化是显式例外
2

v2.0.0 (2026-07-28)

  • SubscriptionPaymentInfo.cashierLanguage 和 SubscriptionPaymentInfoResponse.cashierLanguage 改为 String，可传 API 支持的 IETF BCP 47 语言标签
  • PayMethodDetail 新增 payMethodType、currency、orderAmountMin、orderAmountMax 和 refundAllowed，currentStatus 可为空
  • 保留并扩充 CashierLanguage 便捷常量到当前 22 个语言码；它只是便捷快照，不再作为 SDK 本地输入白名单
  • 迁移时需要把 enum 参数改为字符串或 .getValue()；如果只替换 JAR，建议清理旧缓存或 shaded 副本并 clean rebuild
3

v1.5.0 (2026-07-17)

  • 新增 Wallet 地址查询、x402 订单数据、promotion 字段和类型化 x402 支付 Webhook 数据
  • 保留已废弃的旧订单和订阅字段/类型，同时让当前 wire contract 与最新 OpenAPI specification 对齐
  • 发布校验会在 shared schema field vector 过期时失败
4

v1.4.1 (2026-07-06)

  • 兼容性发布：保持 subscriptionManagementUrl 可选
  • 对齐 payMethodDetails 的 SDK schema 和 E2E 校验门禁
5

v1.4.0 (2026-06-02)

  • 支持将 orderFailedReason、refundFailedReason 和订阅 failedReason 按对象或 JSON 字符串解析
  • 保留既有失败原因访问方式，并在收到普通字符串时保留原始说明
6

v1.3.0 (2026-05-13)

  • 新增 subscription().update()，支持更新订阅金额、试用期金额和计划金额
  • 新增 SubscriptionScheduledAmount、SubscriptionUpdateProductInfo、UpdateSubscriptionParams 和 UpdateSubscriptionData
  • 新增订阅扩展信息、Token 卡信息、卡 BIN 和商品详情等类型化字段
7

v1.2.0 (2026-03-14)

  • 类型对齐：所有 SDK 类型字段与 openapi.json 定义保持一致
  • 修复 Java 8 兼容性问题
  • 添加 Capture 端到端（E2E）测试与 Schema 字段校验测试
8

v1.1.2 (2026-03-10)

  • 自动注入 RefundOrderParams.requestedAt
  • 添加 SUBSCRIPTION_CHANGE_NOTIFICATION Webhook 处理
  • 修复 RefundOrderParams 字段对齐问题
9

v1.1.1 (2026-03-01)

  • 重要修复：buildSuccessResponse() 返回 {"message":"success"}，不再返回 {"status":"SUCCESS"}
10

v1.1.0 (2026-02-24)

  • 自动注入时间戳
  • 将 CancelOrderParams.orderRequestedAt 类型从 String 改为 Instant

​
Go SDK (waffo-go)

1

v2.0.1 (2026-07-29) — 最新

  • 修正 Go v2 模块路径为 github.com/waffo-com/waffo-go/v2，符合 Go modules 对 v2+ 的路径要求
  • v2.0.0 tag 使用了 v1 模块路径，无法通过 Go proxy 解析；请使用 v2.0.1
2

v2.0.0 (2026-07-29)

  • 破坏性变更：order.CreateOrderParams.PaymentTokenData 和 merchant.InquiryMerchantConfigData.TotalDailyLimit / RemainingDailyLimit / TransactionLimit 改为 string，与 API 合同中的 JSON-string 字段一致
  • 移除仅用于旧对象类型的 order.PaymentTokenData struct
  • Schema 校验现在会对比 OpenAPI 字段类型，而不只对比 JSON tag 名
3

v1.6.0 (2026-07-28)

  • PayMethodDetail 新增 PayMethodType、Currency、OrderAmountMin、OrderAmountMax 和可选 RefundAllowed
  • CurrentStatus 在实时可用性暂不可用时可为空
4

v1.5.0 (2026-07-17)

  • 新增 Wallet 地址查询、x402 订单数据、promotion 字段和类型化 x402 支付 Webhook 数据
  • 保留已废弃的旧订单和订阅字段/类型，同时让当前 wire contract 与最新 OpenAPI specification 对齐
  • 发布校验会在 shared schema field vector 过期时失败
5

v1.4.1 (2026-07-06)

  • 兼容性发布：保持 SubscriptionManagementURL 可选
  • 对齐 payMethodDetails 的 SDK schema 和 E2E 校验门禁
6

v1.4.0 (2026-05-13)

  • 新增 Subscription().Update()，支持更新订阅金额、试用期金额和计划金额
  • 新增 ScheduledAmount，支持订阅创建、变更、更新和查询中的计划金额
  • 新增订阅扩展信息、Token 卡信息、卡 BIN 和商品详情等类型化字段
  • Order().Capture() 未传 CaptureRequestedAt 时自动注入当前时间
  • 扩展 Schema 字段校验覆盖必填字段和嵌套订阅/订单结构
7

v1.3.2 (2026-05-12)

  • Webhook 失败原因解析支持 JSON 字符串格式的 orderFailedReason、refundFailedReason 和订阅 failedReason
  • 新增支付、退款和订阅失败回调测试
  • 退款 E2E 流程改用 DANA，并让沙箱前置条件缺失时显式失败或跳过
8

v1.3.1 (2026-03-16)

  • 修复 Go module 代理缓存问题
9

v1.3.0 (2026-03-14)

  • 类型对齐：所有 SDK 类型字段与 openapi.json 定义保持一致
  • 修复 merchantConfig 和 payMethodConfig 的接口路径
  • 添加 RefundStatus、OrderStatus 与 SubscriptionStatus 常量
  • 添加 Capture 端到端（E2E）测试与 Schema 字段校验测试
10

v1.2.2 (2026-03-03)

  • 修复 RefundOrderParams 字段，使其与 openapi.json 对齐
  • 添加退款 Webhook 端到端（E2E）测试
11

v1.2.1 (2026-03-01)

  • 重要修复：BuildSuccessResponse() 返回 {"message":"success"}，不再返回 {"status":"success"}
12

v1.2.0 (2026-02-24)

  • 自动注入时间戳

​
Python SDK (waffo)

1

v0.4.0b0 (2026-07-28) — 最新

  • PayMethodDetail 新增 pay_method_type、currency、order_amount_min、order_amount_max 和 refund_allowed
  • current_status 在实时可用性暂不可用时可为空
2

v0.3.0b0 (2026-07-17)

  • 新增 Wallet 地址查询、x402 订单数据、promotion 字段和 x402 Webhook payload 覆盖
  • merchantInfo 省略时，Wallet 查询参数支持由 SDK 从配置自动注入
  • 保留已废弃的生成模型名和旧订单/订阅字段，维持源码兼容
  • schema drift 校验现在会发现过期的 shared schema field vector
3

v0.2.0b1 (2026-07-06)

  • 兼容性发布：保持 subscriptionManagementUrl 可选
  • 对齐 payMethodDetails 的 SDK schema 和 E2E 校验门禁
4

v0.2.0b0 (2026-05-13)

  • 新增 subscription.update()，支持更新订阅金额、试用期金额和计划金额
  • 新增计划金额模型，覆盖订阅创建、变更、更新和查询字段
  • 扩展订单 capture 时间戳自动注入和 schema 字段校验覆盖
5

v0.1.0b0 (2026-05-09)

  • 发布首个 Python beta 版本
  • 支持支付、退款、订阅、商户配置、支付方式配置和 Webhook 签名验证