> ## 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.

# API バージョン履歴

> Waffo API のバージョン履歴と変更履歴。

<Note>
  本ページは **Waffo API** のバージョン履歴です。**SDK パッケージ**（Node.js / Java / Go）の更新については [SDK 変更履歴](/docs/ja/developer-docs/sdk/changelog) を参照してください。
</Note>

| バージョン | 日付         | 変更内容                                                                                                                                                                                                                                                                                                   |
| ----- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| v1.3  | 2026-07-24 | サブスクリプション作成リクエストの `subscriptionManagementUrl` を必須としてマークしました。`PayMethodDetail` に通貨、注文金額の上下限、決済手段タイプ、返金対応フィールドを追加し、`currentStatus` は必須としてマークされなくなりました。Payout 注文データ `PayoutOrderData` の `mid` と `subMid` を復元し、Payout の受取人アカウント、説明、用途のガイダンスを更新しました。`AcqCardInfo` のカード番号、有効期限、CVV、カード名義人名は必須としてマークされなくなりました |
| v1.3  | 2026-07-22 | 注文作成およびサブスクリプション作成リクエストの `userEmail` 説明を明確化。このフィールドは必須であり、実際のメールアドレスがない場合はユーザー ID を基にした一意の fallback メールアドレスを渡し、プレースホルダー値や複数ユーザーで共有するメールアドレスは避ける必要があります                                                                                                                                                 |
| v1.3  | 2026-07-20 | OpenAPI のネストされたオブジェクトの schema 名を更新し、親リクエストまたはレスポンスのコンテキストを含めることで、`MerchantInfo`、`PromotionInfo`、`SubscriptionInfo` などの共有オブジェクトを区別し、コンポーネント名の衝突を回避                                                                                                                                                      |
| v1.3  | 2026-07-17 | IETF BCP 47 に準拠しないチェックアウトページの言語値を示す公開エラーコード A0047 を追加                                                                                                                                                                                                                                                  |
| v1.3  | 2026-07-15 | Payout 注文データ `PayoutOrderData` に実際の手数料金額フィールド `actFeeAmount` を追加し、フィールド `feeAmount`、`mid`、`subMid` を削除                                                                                                                                                                                                 |
| v1.3  | 2026-07-13 | Auth-Capture の手動売上確定に使用する注文 capture API `POST /api/v1/order/capture` を追加                                                                                                                                                                                                                               |
| v1.3  | 2026-07-08 | 公開エラーコード表を一時的に同期し、A0025、A0028、A0033-A0037、A0039-A0046、B0008-B0013、D0002 を追加。サブスクリプション作成およびサブスクリプション変更の `payMethodName` 最大長を 24 から 256 に変更。サブスクリプション作成の `paymentInfo` 例を追加。注文作成の `payMethodProperties` 説明を明確化                                                                                           |
| v1.2  | 2023-09-15 | Direct Payment プロダクトタイプを追加。エラーコード A0019、A0020、A0021 を更新                                                                                                                                                                                                                                                |
| v1.1  | 2023-05-31 | `riskData` リスクコントロールデータを追加。BNPL 決済手段向けに AddressInfo と GoodsInfo を追加。エラーコードを更新                                                                                                                                                                                                                          |
| v1.0  | 2023-03-15 | 初回リリース                                                                                                                                                                                                                                                                                                 |
