本ページは Waffo API のドキュメントおよび外部契約の改訂系列を記録します。以下の
v1.3 はリクエストヘッダー X-API-VERSION の値ではありません。生 HTTP リクエストでは現在 1.0.0 を使用します。SDK を使用する場合、このヘッダーは SDK が自動的に管理するため、手動で設定または上書きしないでください。SDK パッケージ（Node.js / Java / Go / Python / PHP）の更新については SDK 変更履歴 を参照してください。| バージョン | 日付 | 変更内容 |
|---|---|---|
| v1.3 | 2026-10-26 | 決済 session の有効性、重複注文、確認 token、送信状態、必須フィールド、決済認証情報、事前決済検証、見積もり期限切れの検証向けに、公開エラーコード A0063–A0070 を追加しました。 |
| v1.3 | 2026-10-23 | accounts、funding、cards、transactions を対象とする 14 個の Issuing API と、注文および Subscription の session 作成・更新、ブラウザー session の info・validate・confirm を対象とする 7 個の Waffo Element session API を追加。Chargeback ファイルのダウンロードは、クエリパラメーターと 302 リダイレクトを使う GET /api/v1/chargeback/file/download から、downloadUrl と expiresAt を返す POST JSON リクエストへ変更しました。ダウンロード URL の有効期間は 5 分です。ファイルアップロードでは X-SIGNATURE と multipart の meta・file パートが必須になり、JSON 文字列の meta に必須の merchantId、filename、sha256、timestamp を含めます。署名には元の meta 文字列を使用し、アップロードレスポンスは引き続き X-SIGNATURE を返しません。Subscription 作成に paymentTokenData、paymentInfo.userPaymentAccessToken、userInfo.userAgent、userInfo.userBrowserIp を追加し、Apple Pay/Google Pay の paymentTokenData を直接渡す場合は後ろの 2 つのブラウザーフィールドが条件付きで必須になります。scheduledCancelAt は Subscription の終了時刻を超えられず、終了時刻がない場合は現在から 2 年以内とし、利用前に Waffo テクニカルサポートへ有効化を依頼する必要があることを明記しました。Payout の payoutMethodProperty.bankCode の説明を必須から条件付きへ変更しました。 |
| v1.3 | 2026-10-22 | PAYMENT_NOTIFICATION の subscriptionInfo.subscriptionEvent の値を説明：PERIOD_CHARGE（期間課金）、USER_ADD_PAYMENT_METHOD（決済手段の追加）、TOPUP_CHARGE（Subscription のアップグレードや追加購入に伴う差額課金）。本体のステータス通知と期間ごとの最終決済結果通知の違いを明確にし、利用権付与前に期間、金額、決済結果を確認する指針を追加しました。 |
| v1.3 | 2026-10-19 | Payout 作成リクエスト、作成レスポンス、照会レスポンスの受取人情報の説明を明確化。payeeType が INDIVIDUAL の場合は payeeInfo、BUSINESS の場合は receivingBusinessInfo を使用します。フィールド構造と必須指定に変更はありません。 |
| v1.3 | 2026-10-16 | エラーコード A0061 を追加しました: 加盟店は MIT を開始する権限がありません（HTTP 400）。 |
| v1.3 | 2026-10-12 | Subscription の予定キャンセルを撤回する POST /api/v1/subscription/resume を追加。Subscription のキャンセルリクエスト、キャンセルレスポンス、照会レスポンスに scheduledCancelAt を追加し、予定キャンセルの発効前はキャンセルレスポンスの orderStatus が ACTIVE であることを明記。注文作成、返金、およびそれぞれの照会レスポンスに taxInfo を追加し、注文と返金の照会レスポンスに orderTaxAmount を追加。税込金額を代わりに指定する場合、orderAmount と refundAmount は無条件の必須項目ではなくなり、refundAmount の最大長は 24 になりました。Payout の作成と照会に payeeType、receivingBusinessInfo を追加。PayeeInfo.payeeType を非推奨とし、必須指定を削除。作成リクエストの payeeInfo の必須指定も削除。Payout の EWALLET 識別子タイプ PHONE の説明を既定値から推奨値へ更新 |
| v1.3 | 2026-10-09 | 申告税額検証シナリオ向けに公開エラーコード A0051、A0052、A0053 を追加。サブスクリプションの予定キャンセル検証シナリオ向けに A0056、A0058、A0059、A0060、A0062 を追加 |
| v1.3 | 2026-09-29 | Subscription 作成・照会・管理レスポンスの subscriptionStatus ステータス説明に PLATFORM_CANCELLED を追加 |
| v1.3 | 2026-09-08 | サブスクリプション更新リクエストおよびレスポンスに seat add-on top-up の topupInfo を追加し、サブスクリプション照会の支払い明細に topupDetails を追加。サブスクリプション作成、変更、照会の支払い情報に payMethodCountry を追加し、サブスクリプション変更リクエストに cashierLanguage を追加。Payout 注文データ PayoutOrderData に purpose を追加し、feeStatus、mid、subMid を削除。PayeeInfo.payeeId は必須としてマークされなくなりました。Chargeback 証拠フィールド EvidenceField.evidenceFields を公開 schema から削除。Chargeback および Reported Fraud 一覧レスポンスのページング schema 名を ApiPageResponse... に変更 |
| v1.3 | 2026-09-07 | サブスクリプション変更処理中およびカードステータス検証シナリオ向けに、公開エラーコード A0055、B0014、B0015、B0016 を追加 |
| v1.3 | 2026-08-24 | Reported Fraud 照会 API POST /api/v1/fraud-report/list を追加。注文およびサブスクリプションの支払い情報に receiptTemplateId を追加。Chargeback 詳細および一覧レスポンスに merchantOrderId を追加。Chargeback 照会リクエストの chargebackId と originalOrderId は必須としてマークされなくなりました |
| v1.3 | 2026-08-21 | サブスクリプションのプラン変更が決済中、キャンセル処理中、決済成功済み、または別の変更リクエスト処理中であることを示す公開エラーコード A0048、A0049、A0050、A0054 を追加 |
| v1.3 | 2026-08-20 | ポイントチャージ（Waffo Point Topup）API を追加しました：GET /redirect 署名リダイレクトエンドポイント、POST /api/v1/gamepin/fulfillment-inquiry 即時履行結果照会、および FULFILLMENT_RESULT_NOTIFY 履行結果通知 Webhook |
| 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 | 初回リリース |