> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 変更履歴

> Waffo Node.js、Java、Go、Python SDK のリリース変更履歴。

<Note>
  本ページは **Waffo SDK パッケージ**（Node.js / Java / Go / Python）のリリースを記録します。**Waffo API** のバージョン履歴は [API バージョン履歴](/docs/ja/developer-docs/tools-and-references/references/changelog) を参照してください。
</Note>

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

<Steps>
  <Step title="v2.6.0 (2026-07-17) — 最新">
    * Wallet アドレス照会、x402 注文データ、promotion フィールド、型付き x402 支払い Webhook データを追加
    * 非推奨の旧注文/サブスクリプションフィールドと型を保持しつつ、現在の wire contract を最新の OpenAPI specification に合わせました
    * shared schema field vector が古い場合、リリース検証が失敗するようになりました
  </Step>

  <Step title="v2.5.1 (2026-07-06)">
    * `subscriptionManagementUrl` を省略した場合も `subscription().create()` の後方互換性を維持するよう修正
    * `subscriptionManagementUrl` フィールドは引き続きサポートし、既存のペイロードを API 呼び出し前に拒否しないようにしました
  </Step>

  <Step title="v2.5.0 (2026-05-13)">
    * `subscription().update()` を追加し、サブスクリプション金額、トライアル金額、スケジュール済み金額の更新に対応
    * `ProductInfo` に `scheduledAmounts` を追加し、サブスクリプションの作成、変更、更新、照会で計画金額を利用可能にしました
    * サブスクリプション拡張情報、トークンカード情報、カード BIN、商品詳細の型付きフィールドを追加
    * `Order().Capture()` で `captureRequestedAt` 未指定時に現在時刻を自動付与
  </Step>

  <Step title="v2.4.0 (2026-03-14)">
    * 型の整合化: SDK のすべての型フィールドが openapi.json の定義と一致するようになりました
    * `merchantConfig` および `payMethodConfig` のエンドポイントパスを修正
    * `CaptureOrderParams` に `captureRequestedAt` フィールドを追加
    * `PaymentInfo` に `captureMode` フィールドを追加
    * Capture の E2E テストおよびスキーマフィールドのバリデーションテストを追加
  </Step>

  <Step title="v2.3.4 (2026-03-10)">
    * `RefundOrderParams.requestedAt` を任意に変更。SDK が現在の UTC 時刻を自動的に付与します
  </Step>

  <Step title="v2.3.3 (2026-03-03)">
    * `RefundOrderParams` のフィールド名と型を openapi.json に合わせて修正
    * `notifyUrl` を `refundNotifyUrl` にリネーム
    * 返金 Webhook の E2E テストを追加
  </Step>

  <Step title="v2.3.2 (2026-03-02)">
    * `SUBSCRIPTION_CHANGE_NOTIFICATION` Webhook イベントの処理を追加
  </Step>

  <Step title="v2.3.1 (2026-03-01)">
    * **重要な修正**: `buildSuccessResponse()` が `{"status":"success"}` ではなく `{"message":"success"}` を返すように変更
  </Step>

  <Step title="v2.3.0 (2026-02-24)">
    * タイムスタンプの自動付与: `orderRequestedAt` および `requestedAt` が未指定の場合、自動的に設定されます
  </Step>
</Steps>

***

## Java SDK (waffo-java)

<Steps>
  <Step title="v1.5.0 (2026-07-17) — 最新">
    * Wallet アドレス照会、x402 注文データ、promotion フィールド、型付き x402 支払い Webhook データを追加
    * 非推奨の旧注文/サブスクリプションフィールドと型を保持しつつ、現在の wire contract を最新の OpenAPI specification に合わせました
    * shared schema field vector が古い場合、リリース検証が失敗するようになりました
  </Step>

  <Step title="v1.4.1 (2026-07-06)">
    * 互換性リリースとして `subscriptionManagementUrl` を任意のまま維持
    * `payMethodDetails` の SDK schema と E2E ゲートを整合
  </Step>

  <Step title="v1.4.0 (2026-06-02)">
    * `orderFailedReason`、`refundFailedReason`、サブスクリプションの `failedReason` をオブジェクトまたは JSON 文字列として解析できるようにしました
    * 既存の失敗理由アクセスを維持し、通常の文字列で届いた失敗説明も保持します
  </Step>

  <Step title="v1.3.0 (2026-05-13)">
    * `subscription().update()` を追加し、サブスクリプション金額、トライアル金額、スケジュール済み金額の更新に対応
    * `SubscriptionScheduledAmount`、`SubscriptionUpdateProductInfo`、`UpdateSubscriptionParams`、`UpdateSubscriptionData` を追加
    * サブスクリプション拡張情報、トークンカード情報、カード BIN、商品詳細の型付きフィールドを追加
  </Step>

  <Step title="v1.2.0 (2026-03-14)">
    * 型の整合化: SDK のすべての型フィールドが openapi.json の定義と一致するようになりました
    * Java 8 互換性の問題を修正
    * Capture の E2E テストおよびスキーマフィールドのバリデーションテストを追加
  </Step>

  <Step title="v1.1.2 (2026-03-10)">
    * `RefundOrderParams.requestedAt` の自動付与
    * `SUBSCRIPTION_CHANGE_NOTIFICATION` Webhook の処理を追加
    * `RefundOrderParams` のフィールド整合性に関する問題を修正
  </Step>

  <Step title="v1.1.1 (2026-03-01)">
    * **重要な修正**: `buildSuccessResponse()` が `{"status":"SUCCESS"}` ではなく `{"message":"success"}` を返すように変更
  </Step>

  <Step title="v1.1.0 (2026-02-24)">
    * タイムスタンプの自動付与
    * `CancelOrderParams.orderRequestedAt` の型を String から Instant に変更
  </Step>
</Steps>

***

## Go SDK (waffo-go)

<Steps>
  <Step title="v1.5.0 (2026-07-17) — 最新">
    * Wallet アドレス照会、x402 注文データ、promotion フィールド、型付き x402 支払い Webhook データを追加
    * 非推奨の旧注文/サブスクリプションフィールドと型を保持しつつ、現在の wire contract を最新の OpenAPI specification に合わせました
    * shared schema field vector が古い場合、リリース検証が失敗するようになりました
  </Step>

  <Step title="v1.4.1 (2026-07-06)">
    * 互換性リリースとして `SubscriptionManagementURL` を任意のまま維持
    * `payMethodDetails` の SDK schema と E2E ゲートを整合
  </Step>

  <Step title="v1.4.0 (2026-05-13)">
    * `Subscription().Update()` を追加し、サブスクリプション金額、トライアル金額、スケジュール済み金額の更新に対応
    * `ScheduledAmount` を追加し、サブスクリプションの作成、変更、更新、照会で計画金額を利用可能にしました
    * サブスクリプション拡張情報、トークンカード情報、カード BIN、商品詳細の型付きフィールドを追加
    * `Order().Capture()` で `CaptureRequestedAt` 未指定時に現在時刻を自動付与
    * 必須フィールドとネストされたサブスクリプション/注文構造を対象に、スキーマフィールド検証を拡張
  </Step>

  <Step title="v1.3.2 (2026-05-12)">
    * JSON 文字列形式の `orderFailedReason`、`refundFailedReason`、サブスクリプションの `failedReason` を Webhook 失敗理由として解析できるようにしました
    * 支払い、返金、サブスクリプションの失敗コールバックテストを追加
    * 返金 E2E フローを DANA に変更し、サンドボックス前提条件がない場合は明示的に失敗またはスキップするようにしました
  </Step>

  <Step title="v1.3.1 (2026-03-16)">
    * Go モジュールプロキシのキャッシュに関する問題を修正
  </Step>

  <Step title="v1.3.0 (2026-03-14)">
    * 型の整合化: SDK のすべての型フィールドが openapi.json の定義と一致するようになりました
    * `merchantConfig` および `payMethodConfig` のエンドポイントパスを修正
    * `RefundStatus`、`OrderStatus`、`SubscriptionStatus` 定数を追加
    * Capture の E2E テストおよびスキーマフィールドのバリデーションテストを追加
  </Step>

  <Step title="v1.2.2 (2026-03-03)">
    * `RefundOrderParams` のフィールドを openapi.json に合わせて修正
    * 返金 Webhook の E2E テストを追加
  </Step>

  <Step title="v1.2.1 (2026-03-01)">
    * **重要な修正**: `BuildSuccessResponse()` が `{"status":"success"}` ではなく `{"message":"success"}` を返すように変更
  </Step>

  <Step title="v1.2.0 (2026-02-24)">
    * タイムスタンプの自動付与
  </Step>
</Steps>

***

## Python SDK (waffo)

<Steps>
  <Step title="v0.3.0b0 (2026-07-17) — 最新">
    * Wallet アドレス照会、x402 注文データ、promotion フィールド、x402 Webhook payload のカバレッジを追加
    * SDK が設定から注入する場合、Wallet 照会パラメータで `merchantInfo` を省略できるようになりました
    * 非推奨の生成モデル名と旧注文/サブスクリプションフィールドを保持し、ソース互換性を維持
    * schema drift 検証で古い shared schema field vector を検出できるようになりました
  </Step>

  <Step title="v0.2.0b1 (2026-07-06)">
    * 互換性リリースとして `subscriptionManagementUrl` を任意のまま維持
    * `payMethodDetails` の SDK schema と E2E ゲートを整合
  </Step>

  <Step title="v0.2.0b0 (2026-05-13)">
    * `subscription.update()` を追加し、サブスクリプション金額、トライアル金額、スケジュール済み金額の更新に対応
    * サブスクリプションの作成、変更、更新、照会フィールド向けにスケジュール済み金額モデルを追加
    * 注文 capture のタイムスタンプ自動付与と schema フィールド検証範囲を拡張
  </Step>

  <Step title="v0.1.0b0 (2026-05-09)">
    * 最初の Python beta 版を公開
    * 決済、返金、サブスクリプション、加盟店設定、支払い方法設定、Webhook 署名検証に対応
  </Step>
</Steps>