本ページは Waffo API のドキュメントおよび外部契約の改訂系列を記録します。以下の
v1.3 はリクエストヘッダー X-API-VERSION の値ではありません。生 HTTP リクエストでは現在 1.0.0 を使用します。SDK を使用する場合、このヘッダーは SDK が自動的に管理するため、手動で設定または上書きしないでください。SDK パッケージ(Node.js / Java / Go / Python / PHP)の更新については SDK 変更履歴 を参照してください。| バージョン | 日付 | 変更内容 |
|---|---|---|
| v1.3 | 2026-11-16 | 返金照会レスポンス AcqOrderRefundInquiry に必須の merchantId を追加しました。Payout 作成リクエスト PayoutOrderRequest では、notifyUrl、payeeType、payoutAmount、purpose を必須として明示しました。OpenAPI の必須制約が厳しくなるため、生成クライアントやリクエスト検証への影響を確認してください。この仕様変更だけで実行時の検証が変わったとは判断できません。エンドポイントのパス、フィールドの型、列挙値、長さ制約に変更はありません。 |
| v1.3 | 2026-11-13 | Cashier の paymentInfo.cashierLanguage に fr-FR、de-DE、nl-NL、it-IT、cs-CZ、sv-SE を追加しました。ブラウザの Accept-Language 照合でも主言語 fr、de、nl、it、cs、sv に対応しました。国または地域のフォールバックのマッピングは変更ありません。 |
| v1.3 | 2026-11-09 | Subscription seat add-on の支払い済み、決済中、キャンセル中を表す公開エラーコード A0076–A0078 と、決済手段に MIT 対応の決済チャネルがない場合の A0080 を追加しました。4 つとも HTTP 400 を返します。 |
| v1.3 | 2026-11-09 | 送金先の国、通貨、Payout 方式、受取人種別に応じて、作成時の必須・条件付き必須フィールドを照会する POST /api/v1/payout/beneficiary-fields/inquiry を追加しました。リクエストでは country、payeeType、payoutCurrency、payoutMethodType が必須で、EWALLET と PROXY では payoutMethodName が条件付き必須です。レスポンスにはフィールドの制約、許容値、形式、参照文書が含まれます。最新の Payout facade では、非推奨の PayeeInfo.payeeType と派生属性 payeeFullName を公開 schema から非表示にしました。これらの属性に依存する生成クライアントは確認が必要です。実行時のフィールドが削除されたことを示すものではありません。 |
| v1.3 | 2026-11-02 | Wallet 照会レスポンスのトップレベルの network、asset、payTo を paymentOptions[] に置き換えました。各要素にはこれらのフィールドと decimals が含まれます。呼び出し側の対応が必要な互換性リスクがあります。注文作成、session 更新、作成・照会レスポンスに mppInfo を追加し、Subscription 照会の PaymentDetail に repaymentDetails を追加しました。決済手段設定に userCurrency を追加し、currency が金額上限・下限に使用する注文通貨であることを明確にしました。注文と Subscription のリスクデータの userRegistrationIp と userLastSeenIp の最大長を 24 から 64 に拡張しました。Payout の BANK_ACCOUNT で payoutMethodName を省略した場合の既定値は {country}_BANK です。14 個の Issuing API に、非同期の資金処理、カード凍結、機密カード情報へのアクセス制限などの説明を追加しました。エンドポイント、必須指定、型、enum に変更はありません。 |
| v1.3 | 2026-10-30 | エージェント決済認証情報と Subscription 期間の返済状態検証向けに公開エラーコード A0071–A0075 を追加し、カード決済手段のない決済 session でカード tokenization session を作成できない場合の A0079 を追加しました。 |
| v1.3 | 2026-10-27 | アカウント残高・履歴照会と Withdraw の consult・create・inquiry を含む 5 個の Withdraw API、および transaction limit の作成・照会・更新を含む 3 個の Risk Control API を追加しました。メインの OpenAPI 仕様から 3 個の /web/v1/session/* ブラウザー session エンドポイントを除外しました。 |
| 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 を追加し、フィールド mid、subMid を削除。feeAmount は非推奨となったため、actFeeAmount を参照してください |
| 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 | 初回リリース |