# Waffo Documentation: Japanese ガイド

## ガイド

### 製品とサービス

- [Waffo製品概要](https://waffo.com/docs/ja/essentials/product-overview.md): グローバル決済インフラの構築。アクワイアリングから成長までを網羅するフルスタックソリューション。

### 決済・支払い

- [チェックアウト](https://waffo.com/docs/ja/essentials/checkout.md): Waffoの標準化されたチェックアウト製品。ワンタイム決済とサブスクリプション決済のグローバルな決済インタラクションフローを一元的に管理します。
- [ワンタイム決済](https://waffo.com/docs/ja/essentials/one-time-payment.md): 一度の連携で、世界主要な決済手段に対応。すべての取引を、明確にコントロール。
- [サブスクリプションと継続課金](https://waffo.com/docs/ja/essentials/subscription-recurring.md): 継続決済シナリオ向けに、自動化された高成功率の課金ソリューションを提供します。一度の承認で複数回の自動引き落としを行うメカニズムを通じて、柔軟な課金サイクル設定とスマートリトライをサポートします。
- [決済手段](https://waffo.com/docs/ja/essentials/payment-methods.md): 単一の統一APIインターフェースを通じて、グローバル主流およびユニークなローカル決済手段にビジネスを接続します。

### 精算・資金

- [加盟店精算](https://waffo.com/docs/ja/essentials/merchant-settlement.md): インテリジェントで透明性の高いグローバル資金精算サービス。多通貨取引を自動で換算し、柔軟な精算戦略によって加盟店のキャッシュフローを的確に最適化します。
- [加盟店ポータル](https://waffo.com/docs/ja/essentials/merchant-portal.md): クロスボーダー企業向けのワンストップ決済管理プラットフォーム。取引、精算、分析、チームアクセスを一箇所で管理できます。

### グローバル税務 / MoR

- [税務](https://waffo.com/docs/ja/essentials/tax.md): Waffo Global Taxは、クロスボーダーデジタルビジネス向けに特別に設計されたインテリジェントな税務ソリューションです。お客様の顧客が米国、EU/英国、アジア太平洋地域のどこにいても、現地の税務コンプライアンスを自動的に識別し処理します。

### 付加価値サービス

- [ディスピュートとチャージバック](https://waffo.com/docs/ja/essentials/dispute-chargeback.md): チャージバックアラート、カスタマーディスピュート、チャージバックの3つのコアステージを網羅する、体系的で階層的なクローズドループ防衛システム。
- [データインテリジェンス](https://waffo.com/docs/ja/essentials/data-intelligence.md): 不明瞭な銀行コードを実行可能な成長戦略に変換するエンドツーエンドのデータインテリジェンス。

### 高度な機能

- [トークナイゼーション](https://waffo.com/docs/ja/essentials/tokenization.md): Waffoトークンを使用して決済情報を安全に保存し、生のカード番号を扱うことなく、ワンクリック決済、継続課金、遅延請求を実現します。
- [Auth-Capture](https://waffo.com/docs/ja/essentials/auth-capture.md): 決済を2段階に分割—事前に資金をオーソリし、取引確定時にのみキャプチャすることで、不正リスクと返金コストを削減します。

### ポイントチャージ

- [ポイントチャージ](https://waffo.com/docs/ja/essentials/point-topup.md): Waffo Point Topup は、ポイントカードチャージ API およびホワイトラベル型ポイントカードチャージソリューションです。サプライヤーは API 連携または URL リダイレクトで自社のポイントコード在庫やチャージ機能を接続でき、ストアフロントや決済の構築は不要です。

### サポート FAQ

- [API 認証情報のスコープと認証エラーのトリアージ](https://waffo.com/docs/ja/support/api-credential-scope-and-triage-faq.md): どの API キーがどのエンドポイントを呼び出せるのか、Withdraw を別の認証情報にしなければならない理由、Waffo が API キー・スコープ・署名・IP を確認する正確な順序、A0001 / A0002 / A0004 / A0046 の読み方、そして認証情報の変更が反映されるまでの時間について説明します。
- [API リファレンス表](https://waffo.com/docs/ja/support/api-reference-tables.md): 他の Waffo API ページが参照している 4 つの参照表：国と送金手段ごとの送金受取人フィールドの要件、注文作成時に条件付きで必須になるフィールド、自前のチェックアウトページを構築する加盟店向けの `orderAction.actionData` フィールドの完全な一覧、そして送金・アクワイアリング・サブスクリプション・出金という API ファミリーごとのエラーコード表。
- [認証・署名 FAQ](https://waffo.com/docs/ja/support/auth-signature-faq.md): Waffo API 認証に関するよくある質問への回答：API キーの取得場所、リクエストとレスポンスの署名の仕組み、Webhook の検証、A0001/A0002 のトラブルシューティング、RSA 鍵の生成方法。
- [Waffo は残高を自動で出金できますか？出金はどのように連携すればよいですか？](https://waffo.com/docs/ja/support/auto-withdrawal-and-withdrawal-integration-faq.md): 自動出金契約の全体像 — どのように起動するか、6 つのステータスの意味、残高が閾値を下回っている場合に何が起きるか、一時停止・終了の方法 — に加えて、出金通知イベント、API 出金と Portal 出金の見分け方、出金一覧のエクスポート、出金における openingRegion と fundsFrom の意味。
- [残高と口座履歴](https://waffo.com/docs/ja/support/balance-and-account-history-faq.md): Waffo の 3 つの残高（精算待ち、精算アカウント、Reserve）の読み方、出金可能額が精算残高より少なくなる理由、Account History に記録される内容、Statement と Invoice の PDF の命名規則。
- [銀行振込とバーチャル口座](https://waffo.com/docs/ja/support/bank-transfer-and-virtual-account-faq.md): バーチャル口座（VA）決済と銀行振込決済の挙動について：VA 番号の有効期間と後日再利用されるかどうか、ユーザーが誤った金額を入力した場合に何が起こるか、法定通貨での過払い・不足払いが注文ステータスにどう影響するかを説明します。
- [一括送金のステータスと資金源](https://waffo.com/docs/ja/support/batch-payout-faq.md): 一括送金のステータスと各行のステータスの読み方、バッチが失敗として表示されずにリストから消えることがある理由、一部の国のテンプレートしか提供されない理由、そして送金の資金がどこから引き落とされるのかを説明します。
- [一括返金](https://waffo.com/docs/ja/support/batch-refund-faq.md): Portal の Batch Refunds タブについて：テンプレートの列と上限、アップロード時にどの検証がどの順序で行われるか、重複ファイルと「同時に 1 バッチのみ」のルール、バッチのステータス、行ごとの失敗理由がどこで確認できるか。
- [チェックアウトページのカスタマイズ（ブランディング、カラー、ロゴ）](https://waffo.com/docs/ja/support/cashier-customization-faq.md): Waffo チェックアウトページのブランディング方法：Portal 内で Customization がどこにあるか、設定できるすべてのカラーとサイズ、注文作成時にフォントサイズを制御するフィールド、注文パラメーターが Portal 設定を上書きする仕組み、MID と SubMID の設定、複数ロゴとロゴ ID、ライブプレビューとその制限、チームの誰が変更を保存できるか。
- [チェックアウト画面における決済手段の表示ルール](https://waffo.com/docs/ja/support/cashier-display-rules-faq.md): Waffo のチェックアウト画面がどの決済手段をどの順番で表示するかを決める仕組み：加盟店が定義する並び順、新規契約した決済手段、折りたたみ表示、利用不可の決済手段、国別のグループ化、および表示モードのオプション。
- [チェックアウトのフォーム、事前入力、エラー処理](https://waffo.com/docs/ja/support/cashier-forms-and-flow-faq.md): Waffo のチェックアウトで顧客が実際に入力する必要があるもの：貴社が送信した情報が事前入力されるか、決済手段の選択ページがスキップされるのはいつか、カードフォームの検証ルールと文字数、保存済みカードの動作、QR コードの有効期間、そしてどのチェックアウトエラーがリトライされ、どれが直接失敗ページに送られるか。
- [チェックアウトの表示言語](https://waffo.com/docs/ja/support/cashier-language-faq.md): Waffo チェックアウトの言語を設定するフィールド、BCP 47 の正確な形式と検証エラー、チェックアウトが表示言語を選ぶ際の優先順位の全体、およびチェックアウトが描画できる言語の完全な一覧を説明します。
- [チェックアウト画面のライフサイクルと領収書](https://waffo.com/docs/ja/support/cashier-order-lifecycle-faq.md): Waffo のチェックアウト画面が注文のライフサイクル全体でどう振る舞うかを説明します：支払い後のリンク再開、処理中の状態、結果ページのリダイレクト、加盟店表示名、ロゴ、異通貨の金額表示、リピーター顧客の事前入力。
- [チェックアウトのリダイレクトとアクションタイプ](https://waffo.com/docs/ja/support/cashier-redirect-and-action-type-faq.md): orderAction.actionType がどのように決まり、なぜ webUrl と deeplinkUrl が排他的なのか、actionType と userInfo.userTerminal の関係、顧客がチェックアウトで国を切り替えられるのはいつか、サブスクリプションのチェックアウトをリクエストパラメーターでどこまで絞り込めるのか、そして決済手段が複数の通貨で設定されている場合にどの通貨が選ばれるのか。
- [チャージバック証拠ガイド](https://waffo.com/docs/ja/support/chargeback-evidence-guide.md): 再提示（リプレゼントメント）の証拠の選び方：すべての抗弁が答えるべき 3 つの問い、各異議申し立て理由がどの問いに関わるか、物理的商品・デジタル商品・サービスで資料がどう異なるか、理由が不明な場合に何を送るか、貴社が何もしていなくても第 2 サイクルが発生しうる理由、顧客の異議申し立てが自動的にクローズしうる理由。
- [チャージバックと異議申し立てに関する FAQ](https://waffo.com/docs/ja/support/chargeback-faq.md): チャージバックについて加盟店から最もよく寄せられる質問への回答：通知の届き方、チャージバックが開始されたときの対応、再提示（representment）の証拠の提出方法、期限とステータスの流れ、異議申し立て中の注文を返金できない理由。
- [チャージバック項目リファレンス](https://waffo.com/docs/ja/support/chargeback-field-reference.md): 加盟店 Portal と精算ステートメントでチャージバックを読み解くための項目辞書：4 種類の CHARGEBACK Event Type とその符号、Compulsory Channel Review フラグ、顧客の異議申し立てとチャージバックのタイムラインの全イベント、未読カウンターを動かすイベント、チャージバック CSV エクスポートの 26 列、Dispute Amount の算出方法、チャージバック手数料の通貨、日次異議申し立てレポートの Alert Status の値。
- [チャージバックの理由コードと Reported Fraud](https://waffo.com/docs/ja/support/chargeback-reason-codes-and-reported-fraud.md): Waffo が認識する Visa と Mastercard の異議申し立て理由コードの完全な一覧をカテゴリ別にまとめ、各コードが何を主張しているかを説明します。あわせて、Reported Fraud とは何か、チャージバックとどう違うか、どのように照会するかを説明します。
- [自社アプリ内でチェックアウトを読み込む（WebView、アプリ起動、復帰）](https://waffo.com/docs/ja/support/checkout-in-app-webview-faq.md): WebView インテグレーションガイドが答えていないアプリ側の疑問に答えます：Waffo は WebView を検出して顧客に警告するのか、どのドメインを許可すべきか、顧客が戻ってこない場合にアプリはどう決済結果を知るのか、ウォレットアプリを往復した後にチェックアウトは自動で更新されるのか、決済リダイレクトリンクは 2 回開けるのか、ウォレットが開かないときに何を記録すべきか、なぜアプリ起動をサンドボックスでテストできないのか、そして決済手段をアプリ環境だけで非表示にできるのか。
- [決済手段ごとの条件付き必須フィールド](https://waffo.com/docs/ja/support/conditional-required-fields-faq.md): /api/v1/order/create で Optional と記載されているフィールド — goodsId、goodsUniquePrice、skuName、userFirstName、userPhone、address など — がなぜ「不足」として拒否されることがあるのか、不足フィールド一覧にどのフィールドパスが現れうるのか、そして事前に予測するのではなく送信して一覧を読み取るのが正しいパターンである理由。
- [クーポンとプロモーションコード](https://waffo.com/docs/ja/support/coupons-and-promotion-codes-faq.md): Waffo の割引エンジンの全体像：割合割引と定額割引のクーポン、Once / Repeating / Forever の期間、単一およびバッチのプロモーションコード、利用記録、割引分析、アカウントレベルの上限、サブスクリプションのトライアル、返金時の取り消し、2 つの API エントリポイント。
- [通貨を使う前に、その通貨を有効化する必要がありますか？](https://waffo.com/docs/ja/support/currency-and-method-enablement-faq.md): Waffo アカウントで通貨と決済手段が利用可能になる仕組み：注文通貨とユーザー通貨の違い、有効化されている内容をどこで確認するか、有効化されていない通貨が実際に返すエラー、有効化が加盟店 ID 単位かアカウント全体か、同じ決済手段をある市場では現地通貨で別の市場では USD で価格設定できるか、決済手段の追加が稼働中のものに影響するか。
- [限度額・通貨・設定に関するエラー](https://waffo.com/docs/ja/support/error-codes-and-limits-supplement.md): 他のページで扱っていない注文作成時の却下理由：A0008 / A0020 / A0021 の金額限度額の違い、契約外通貨が A0007 ではなく A0018 を返す理由、A0026 / A0047 のチェックアウト言語、A0024 の為替レート期限切れ（A0023 ではありません）、A0014 の換算後にゼロになる通貨間返金、A0022 の決済手段の曖昧さ。さらに、限度額が為替レートに連動しない理由、Portal に精算メニューが表示されない場合がある理由、サンドボックスと本番環境の利用可否の違い、継続課金のルールも扱います。
- [よくあるエラーのトラブルシューティング](https://waffo.com/docs/ja/support/errors-troubleshooting-guide.md): 加盟店が最も頻繁に遭遇する API エラーの診断と修正方法 — 無効な API キー（A0001）、署名の失敗（A0002）、パラメータ検証（A0003）、決済手段/契約の不一致（A0018）、不明ステータスのエラー（Exxxxx）、および再送が止まらない Webhook 通知について説明します。
- [決済と精算における為替レート](https://waffo.com/docs/ja/support/exchange-rates-faq.md): 異通貨の注文がどのレートを使うのか、レートはいつ提示・再提示されるのか、なぜ UTC+8 の日中に現地通貨の金額が変わるのか、適用されたレートは API と Portal のどこに表示されるのか、そして精算と返金はそれぞれどのようにレートを選ぶのかを説明します。
- [エクスポートとレポートのダウンロード](https://waffo.com/docs/ja/support/export-center-faq.md): Portal の一覧エクスポートは即時ダウンロードではなくバックグラウンドタスクです：完成したファイルがどこに表示されるか、4 つのタスクステータスの意味、Failed Count が行の欠落を意味しない理由、ダウンロードリンクの有効期限、エクスポート開始前にブロックされる日付範囲と行数の上限。
- [失敗したカード取引への課金](https://waffo.com/docs/ja/support/failed-transaction-billing-faq.md): 成功しなかったカード決済が精算請求に現れうる理由：どの失敗ステージが課金対象か、Event Type 列の仕組み、失敗行に注文金額がない理由、Merchant Portal でこれらの取引を見つけてエクスポートする方法。
- [手数料と税の取り扱い](https://waffo.com/docs/ja/support/fee-and-tax-treatment-faq.md): Waffo がカード取引にどの手数料条件を適用するかを決める仕組み、3 つの税負担モードの意味とそれぞれの負担者、異議申し立てとチャージバックがお客様の資金に与える影響の違い、チャージバックおよび精算見積エクスポートの制限。
- [セルフサーブ登録、サンドボックス、アカウント認証](https://waffo.com/docs/ja/support/getting-started-self-serve-faq.md): 自己登録した加盟店が実際に歩む道筋：アカウント作成、メールアドレスの確認、会社に関する質問への回答、6 ステップのセットアップウィザードによるサンドボックスの構成、サンドボックス認証情報の取得、そして 7 ステップのアカウント認証の完了（申請が返却された場合の対処を含む）。
- [アカウント認証：申請フォーム、ステータス、変更できること](https://waffo.com/docs/ja/support/kyb-application-lifecycle-faq.md): アカウント認証申請の挙動について：セルフサービスのフォームが受け付ける国と事業形態、必須項目、下書きが保存・共有されるかどうか、誰が提出できるか、各申請ステータスの意味、編集できるタイミング、承認後に何が起こるかを説明します。
- [KYB 書類要件：一度で審査を通すために](https://waffo.com/docs/ja/support/kyb-document-requirements-faq.md): アカウント認証の各書類が受理されるために満たすべき条件を説明します：お客様の国に該当する登記書類、株主構成図の判定基準、パスポートと住所証明のルール、差し戻される可能性のある項目、追加書類の依頼の仕組み、そしてガイドラインのダウンロードリンクが使えなくなる理由。
- [Waffo のチェックアウトを使わず、自社で決済ページを構築する](https://waffo.com/docs/ja/support/merchant-built-checkout-faq.md): 加盟店が自社で構築するチェックアウトが Waffo から得られるもの・得られないもの：orderAction.actionData に値が入るのはいつで空になるのはいつか、どの決済手段が生データとして返ってくるのか、必須の顧客フィールドを検証するのは誰か、決済手段の利用可否と金額範囲を自分で照会する方法、ホスト型と自社構築を注文ごとに併用できるか、そして Waffo のホスト型チェックアウトでしか行われない処理。
- [ミニプログラム決済](https://waffo.com/docs/ja/support/mini-program-payments-faq.md): ウォレットのミニプログラム内で決済を受け付ける方法：連携が必要なフロントエンド JS API と Waffo のエンドポイント、注文作成時に送信する内容、返金の仕組み、userid/inquiry によるユーザーの特定方法、追加スコープが承認されない限りユーザーの公開 ID しか取得できない理由。
- [1つのアカウントで複数ブランドを運営する](https://waffo.com/docs/ja/support/multi-brand-and-sub-merchant-faq.md): SubMID を使って 1 つの Waffo アカウントで複数のブランドや事業ラインを運営する方法——ブランドごとのチェックアウト表示名とロゴ、どのレベルの設定が優先されるか、何も設定していない段階で何が起きるか、何が固定されるか、一部の決済で追加収集される情報、そしてレポート内の USD 金額がどのように換算されるか。
- [どの金額・通貨フィールドを確認すればよいですか？](https://waffo.com/docs/ja/support/order-amount-and-currency-fields-faq.md): 注文には複数の金額（orderAmount、originalAmount、finalDealAmount、ユーザーが実際に支払った金額、ユーザー手数料）が最大 3 つの通貨で含まれます。このページでは、注文を検証する際にどのフィールドを比較すべきか、どのフィールドを基準に商品を出荷すべきか、finalDealAmount が orderAmount と正当に異なる理由、そしてどの通貨で注文を作成すべきかを説明します。
- [注文金額、限度額、決済拒否](https://waffo.com/docs/ja/support/order-amount-precision-and-decline-faq.md): 有効に見える金額が拒否される理由、同一通貨と異通貨の注文で検証がどう異なるか、processingAmountLimits の min/max/multiple の意味、どの限度額がどのエラーコードを生んだか、決済手段のタイプが顧客の支払い可否をどう決めるか、カードの決済拒否の読み方、未払いの注文がどれだけ開いたままになるかを説明します。
- [注文作成の項目ガイド](https://waffo.com/docs/ja/support/order-create-field-guide.md): /api/v1/order/create リクエストの完全な項目表：すべての文字数制限、必須項目、値が長すぎる場合の挙動、再送時に paymentRequestId のべき等チェックが実際にどう動くか、そしてよくある検証エラーの背後にある項目ルール。
- [注文が拒否されました — 原因は自分か、設定か、決済手段か？](https://waffo.com/docs/ja/support/order-rejection-self-diagnosis-faq.md): 加盟店から最も多く寄せられる拒否に関する判断ツリー：A0018 決済手段/契約の不一致とそれを引き起こすすべての次元、キーローテーション後の A0001、C0005 チャネル拒否とそれに付随して返される失敗理由、返金時の A0017、そして未有効化の決済手段と不正なパラメーターの見分け方。
- [各ステータスの注文に対して何ができますか？](https://waffo.com/docs/ja/support/order-status-actions-and-capture-faq.md): ほとんどのマーチャントが目にしない 2 つのステータスを含む注文ステータス一覧、どのステータスがキャンセル・キャプチャ・返金を受け付けるか、注文が AUTHORIZATION_REQUIRED にとどまる理由、クローズ理由がどこに書かれるか、決済手段がすでに資金を受け取っている場合のキャンセルの動作、オーソリ済みカード決済をキャプチャするルール。
- [Payin 契約と取引限度額](https://waffo.com/docs/ja/support/payin-agreements-and-limits-faq.md): Service → Payin の読み方：Payin 契約一覧の各列、手数料と精算サイクルの表記、契約ステータス、金額の上限——さらに 2 つの限度額超過エラーの意味、日次限度額のカウント方法と解放タイミング、チェックアウトでユーザーに表示される名前。
- [Payment Enrollment：審査承認済みでもまだ本番決済ができないのはなぜか](https://waffo.com/docs/ja/support/payment-enrollment-faq.md): 認証は承認されたのに、まだ実際の決済を受け付けられませんか？このページでは、KYB 承認後に続く Payment Enrollment（決済手段の有効化）ステージについて説明します：Activating Payment Capabilities パネルの場所、IN_PROGRESS と COMPLETED の意味、決済手段が Processing のまま止まる理由、そして単一の決済手段が Suspended または Rejected になる意味。
- [支払いリンク（ノーコードでの集金）](https://waffo.com/docs/ja/support/payment-link-faq.md): 何も連携せずに Merchant Portal から支払いを受け取る方法：支払いリンクとは何か、作成時に入力するフィールド、有効期限の仕組み、1 つのリンクがちょうど 1 件の注文になる理由、結果の追跡場所、代わりに Checkout を使うべき場面を説明します。
- [決済手段の設定を読む](https://waffo.com/docs/ja/support/payment-method-config-and-limits-faq.md): アカウントで利用できる決済手段をプログラムから把握する方法：決済手段設定レスポンスのすべての項目、currentStatus が空で返ることがある理由、4 つの refundAllowed コードの意味、加盟店 ID や notifyUrl を名指しするパラメーターエラー、そして変更されたエクスポート列と一覧フィルター。
- [どの決済手段と市場を受け付けられますか？](https://waffo.com/docs/ja/support/payment-method-coverage-faq.md): 公開されている決済手段カタログから、カバレッジに関する質問を自分で解決する方法：どの市場が掲載されているか、テーブルがどのように行を集約しているか、同じ決済手段が 2 つの名前で現れる理由、ある決済手段がサブスクリプションや返金に対応しているかの見分け方、そして自社の契約済み一覧とカタログの違い。
- [決済手段別の返金制限](https://waffo.com/docs/ja/support/payment-method-refund-limits-faq.md): 同じ返金リクエストがある決済手段では成功し別の決済手段では拒否される理由：一部返金の利用可否、返金期間と期限、1 注文で許可される返金回数、重複リクエスト保護、キャプチャ前後の返金、閉鎖されたユーザーアカウント、イシュアに拒否されたカード返金。
- [決済結果の確認](https://waffo.com/docs/ja/support/payment-results-faq.md): 決済が成功したかどうかを確実に判定する方法：リダイレクト、webUrl、Webhook、Order Inquiry それぞれの役割、各 orderStatus の意味、通知が届かないときの対処。
- [タイムアウトと結果が最終確定するタイミング](https://waffo.com/docs/ja/support/payment-timeout-and-finality-faq.md): タイムアウトした注文が決済失敗の証明にならない理由：クローズ時刻に Waffo が行うこと、タイムアウトをどちらの時計が決めるか、どの失敗が通知として届き、どれが照会でのみ判明するか、遅れて届く通知と再送、遅延成功後の自動返却、独立した 3DS 認証タイムアウト、そしてフロントエンドがどれだけ待つべきか。
- [Payout のエラーコードと再試行](https://waffo.com/docs/ja/support/payout-error-codes-and-retry-faq.md): 決済とは異なる Payout のエラーコード群について：各 A/B/C/D/E コードが Payout では何を意味するか、安全に再試行できる 4 つのコード、リクエストの変更が必要なコード、A0003 がフィールド名を含む理由、B で始まるコードが実際には何を指しているのかを説明します。
- [送金 FAQ](https://waffo.com/docs/ja/support/payout-faq.md): Waffo の送金（Payout）に関する最もよくある質問への回答：送金の作成と追跡、通知、国ごとの受取人項目の要件、べき等性、エラーコード。
- [Payout リクエストのフィールドガイド](https://waffo.com/docs/ja/support/payout-request-field-guide.md): Payout の作成リクエストを構築するためのフィールドごとの回答：payoutRequestId の冪等性が実際にどのようにリクエストを比較するか、国によって条件付きになる受取人フィールド、2 つの異なる日付形式、電話番号と PIX キーの形式、コリドーごとの銀行プロパティ、purpose の値、金額の精度、そして API が拒否するフィールド。
- [Payout のステータス、通知、レポート](https://waffo.com/docs/ja/support/payout-status-notifications-and-reports-faq.md): 各 Payout のステータスとサブステータスの意味、DEDUCTED が届かない理由、Payout の Webhook が発火するタイミングとまったく発火しない 2 つのケース、返戻の検知方法、日次・週次・月次の Payout レポートの内容と公開タイミング。
- [Payout ウォレットと対応範囲](https://waffo.com/docs/ja/support/payout-wallet-and-coverage-faq.md): 4 つ目の Waffo アカウント：Payout ウォレットが保持するもの、資金がどのように入り、出ていくか、失敗・取消となった Payout がどのように精算アカウントに戻るか、独立した Account History の読み方、そしてどの Payout コリドーを契約しているかをどこで確認するか。
- [Point Topup リセラー API](https://waffo.com/docs/ja/support/point-topup-reseller-api-faq.md): Point Topup のリセラーが呼び出せる 6 つの署名付きエンドポイント：カタログ照会、購入残高照会、resellerRequestId 冪等キーによる注文作成、単一およびページ単位の注文照会、履行照会、加えて 4 つの注文ステータスと購入通知。
- [Portal のログイン、メールリンク、アカウントステータス](https://waffo.com/docs/ja/support/portal-account-access-faq.md): Merchant Portal からログアウトされる理由、各メールリンクの有効期間、再送が拒否される理由、パスワードの有効期限と再利用のルール、Continue with Google の動作、ログインできるアカウントステータスとできないものを説明します。
- [Portal のダッシュボードと分析](https://waffo.com/docs/ja/support/portal-analytics-faq.md): 加盟店 Portal のダッシュボードの読み方：ホーム画面のデータ更新タイミングと精算カレンダー、Payments Analytics の指標定義、Chargeback Analytics の比率と対象期間、そして取引・返金・精算エクスポートの背後にあるルール。
- [見当たらない列・フィルター・ビュー](https://waffo.com/docs/ja/support/portal-conditional-screens-faq.md): ドキュメントで読んだ Portal の列、フィルター、タブ、編集ボタンが自分の画面にない理由：どの要素が契約由来か、どれがデータがある場合にのみ表示されるか、どの分析ビューが表示されそれはなぜか、時間間隔がグレーアウトする理由、そして通知 URL が拒否された理由。
- [ホームダッシュボード](https://waffo.com/docs/ja/support/portal-dashboard-faq.md): Portal ホームダッシュボードの集計方法：Today パネルの 3 つの TPV 基準値、TPV / Txns / ASP の定義、プロダクト別内訳、5 つの時間粒度、Compare、表示通貨の切り替えで換算されるものとされないもの。
- [Portal 一覧のフィルターと期間](https://waffo.com/docs/ja/support/portal-list-filters-and-date-ranges-faq.md): Merchant Portal の各一覧で何をフィルター・検索できるか、各一覧がデフォルトでどこまで過去を表示するか、どのピッカーが 1 か月を超える期間を拒否するか、1 年分をどうカバーするか、そして一覧上のボタンやファイル名がクリックできないのはなぜか。
- [加盟店 Portal の操作](https://waffo.com/docs/ja/support/portal-operations-faq.md): Waffo 加盟店 Portal におけるアカウントとチームの管理：加盟店ごとにメニューが異なる理由、各ロールでできること、ユーザーの招待と削除、ログインセキュリティと 2 段階認証、インターフェース言語、連携キーの確認場所。
- [領収書：表示、送信、設定](https://waffo.com/docs/ja/support/portal-receipt-faq.md): Merchant Portal で決済の領収書を表示する方法、顧客へのメール送信、配信ステータスの読み方、領収書の内容を制御するものについて説明します。
- [Portal セルフサービスのセキュリティ設定](https://waffo.com/docs/ja/support/portal-security-config-faq.md): 加盟店 Portal で API のセキュリティ設定を管理する方法：チャレンジ文字列の検証を伴う公開鍵の提出とローテーション、返金・チャージバック通知 URL の設定、IP ホワイトリストによる API アクセスの制限。
- [加盟店スイッチャー、Demo Mode、環境](https://waffo.com/docs/ja/support/portal-switcher-and-environments-faq.md): Portal 上部の加盟店 ID ドロップダウンとその横のエイリアス、サブ加盟店フィルターとの違い、Demo Mode バッジの意味と解除方法、サンドボックスと本番が同じアカウントかどうか、管理者が退職した場合の対応。
- [Webhook イベントログと手動再送](https://waffo.com/docs/ja/support/portal-webhook-log-faq.md): Merchant Portal で Webhook の配信状況を確認する方法：何が配信成功とみなされるか、レコードがまったく存在しない理由、各イベントに表示される Order ID、手動再送と自動リトライの関係。
- [本番環境の公開鍵と API 操作タイプ](https://waffo.com/docs/ja/support/production-api-key-and-public-key-faq.md): 本番環境の公開鍵をご自身で提出・ローテーションする方法 — フィールドが受け付ける正確な形式、Portal がチャレンジ文字列への署名を求める理由、3 つの API 操作タイプの意味と Withdraw を単独にしなければならない理由、ローテーション中に新旧の鍵がどのように共存するか。
- [本番決済を受け付けるまでに何をしなければなりませんか？](https://waffo.com/docs/ja/support/production-go-live-faq.md): 本番環境までの道筋全体を 1 ページに：本番決済の前提となるステージ、サンドボックスから切り替えたときに実際に変わること、連携受け入れテストで求められることと簡易テンプレートを使えるタイミング、貴社側の技術準備、そしてすでに本番稼働した後に国や決済手段を追加する方法。
- [領収書の設定とダウンロード](https://waffo.com/docs/ja/support/receipt-configuration-and-download-faq.md): 顧客向けの領収書の一連の仕組み：顧客がダウンロード時に選ぶもの（言語、経費精算用の会社名、それが一度しか設定できない理由）、Portal で設定できること、設定変更が過去の取引に影響するかどうか、領収書の URL、貴社の設定が及ばない取引について説明します。
- [返金 FAQ](https://waffo.com/docs/ja/support/refund-faq.md): Waffo の返金に関する最もよくある質問への回答：複数回の一部返金、返金の前提条件、べき等なリトライ、異通貨の金額と端数処理、返金とキャンセルの違い、処理時間、決済手段の制約。
- [返金の資金はどこから来るのか](https://waffo.com/docs/ja/support/refund-funding-source-faq.md): 返金が実際にどの Waffo 残高から、どの順序で引き落とされるのか、精算で支払われた直後に残高不足で返金が失敗するのはなぜか、返金Reserve口座がそれをどう防ぐのか、そしてこれらが返金 API を一切変えない理由。
- [返金の記録、ID、通知、所要時間](https://waffo.com/docs/ja/support/refund-records-and-notifications-faq.md): 返金が持つすべての識別子と、誰にどれを伝えるべきか、一部の返金で顧客の銀行口座と氏名が求められる理由、それらを誤って入力した場合の対処、返金 Webhook が発火するタイミングと配信先、返金が顧客に届くまでの一般的な所要時間、顧客自身が返金を開始できるかどうか。
- [レポートの配信とメール配信登録](https://waffo.com/docs/ja/support/report-delivery-and-subscription-faq.md): Waffo のレポートファイルがお手元に届く 4 つの方法 — Portal からのダウンロード、Waffo の SFTP、ご自身の SFTP、またはメール — に加えて、精算レポートのメール配信登録をご自身で管理する方法：スケジュール、宛先、本文の言語、送信履歴、配信変更が反映されるタイミング。
- [Reserve口座](https://waffo.com/docs/ja/support/reserve-faq.md): 固定 Reserve とローリング Reserve の違い、留保資金がどのアカウントから拠出されるか、保有期間の数え方、精算期間がマイナスになった場合の扱い、留保がいつ解放されるか、そして加盟店 Portal で Reserve のすべての変動を照合できる場所について説明します。
- [リスクによる拒否と 3D Secure](https://waffo.com/docs/ja/support/risk-declines-and-3ds-faq.md): リスクによる拒否が返すもの、決済手段による拒否との見分け方、3D Secure を強制または省略できるか、貴社の指定が無視される場面、チャレンジが購入者にどう届くか、Portal で拒否・チャージバック・不正率について何が見られるかを説明します。
- [サンドボックス環境とアクセス FAQ](https://waffo.com/docs/ja/support/sandbox-environment-and-access-faq.md): Waffo のサンドボックスがどのように払い出されるのか、どの URL と加盟店 ID がサンドボックスのものか、サンドボックス設定ウィザードの動作と各回答が何を変えるのか、サンドボックスの鍵はどこから来るのか、そしてサンドボックスが本番環境からどう分離されているのかを説明します。
- [サンドボックスのシミュレーション範囲 FAQ](https://waffo.com/docs/ja/support/sandbox-simulation-limits-faq.md): Waffo のサンドボックスで再現できること・できないこと：どの予約金額がどのエラーを発生させるか、返金用の金額が機能しない理由、ウォレット側のキャンセルをシミュレートする方法、シミュレートした更新失敗が再試行されない理由、そしてサンドボックスにまったく経路のないシナリオ。
- [サンドボックステスト FAQ](https://waffo.com/docs/ja/support/sandbox-testing-faq.md): サンドボックスの認証情報の取得方法、決済の成功・失敗のシミュレーション、テストカード番号の使い方、ローカルでの Webhook 受信、サンドボックスと本番環境の違い。
- [加盟店 Portal で自分で変更できるものは何ですか？](https://waffo.com/docs/ja/support/self-service-boundaries-faq.md): 加盟店が質問するオンボーディングと本番稼働のあらゆる設定 — 決済手段、通貨、銀行口座、IP 許可リスト、ドメイン、鍵、注文のタイムアウト、チェックアウトのレイアウト — について、加盟店 Portal でご自身で変更できるのか、Waffo 側で設定されるものなのか、そして問い合わせる代わりにご自身で確認できるものは何か。
- [精算アカウントの構造と Account History のフィルター](https://waffo.com/docs/ja/support/settlement-account-structure-faq.md): 1 つの精算通貨に 2 つの口座番号が表示されるのはなぜか、1 回の出金が 2 件の支払いとして送られるのはなぜか、accountSubType とオーバードラフト限度額フィールドの意味、そして Account History の正しいフィルター値（精算アカウントとReserve口座の両方にわたる 6 つの業務タイプ。Reserve の留保計上、解放、調整を含む）について説明します。
- [精算バッチとカレンダー](https://waffo.com/docs/ja/support/settlement-batch-and-calendar-faq.md): 取引が精算エントリとバッチにどうグループ化されるか、各識別子の意味、精算レコードのステータスのタイムラインが示すもの、Balance History が記録する内容とその絞り込み・エクスポート方法、精算カレンダーの国の軸と休日の詳細の読み方を説明します。
- [精算額の計算を解説](https://waffo.com/docs/ja/support/settlement-calculation-explained.md): Waffo の精算額を 1 行ずつ再現するための解説：4 つのクリアリングステップ、小数 2 桁と 6 桁の精度設定、通貨の組み合わせごとに使われる通貨ペアと端数処理ルール、手数料の下限・上限の適用方法、Return Fee とは何か、そして精算期間がマイナスになると支払いが発生しない理由。
- [精算サイクルとカレンダー](https://waffo.com/docs/ja/support/settlement-cycle-faq.md): 精算日の裏側にある運用ルール：UTC+8 の日次締め、決済手段ごとの精算契約、日次 / 週次 / 半月次 / 月次のサイクルタイプと各タイプでの T+N の数え方、統合された祝日カレンダーに基づく営業日への繰り延べ、精算バッチ、ネットがマイナスになる期間、そして繰り延べされない返金 Reserve の精算。
- [精算データは実際にどこまで取得でき、どこで手に入りますか？](https://waffo.com/docs/ja/support/settlement-data-availability-faq.md): 「このフィールドを追加できますか / これ用の API はありますか」という照合の質問に答えます：取引エクスポート、精算レポート、資金移動 API にどの識別子と切り口が存在するか、まったく存在しないものは何か、同じ月の 3 つのエクスポートが一致しない理由、どの書類が誰に発行されるか。
- [精算ファイル仕様](https://waffo.com/docs/ja/support/settlement-file-specification-faq.md): 3 種類の対帳レポートファイルと、精算ステートメントおよびInvoice PDF の列ごとのリファレンス：各フィールドの意味、小数精度、空になる条件、ファイル命名規則、ファイルの配信先、日付範囲の一括ダウンロード方法。
- [Settlement Reports モジュール](https://waffo.com/docs/ja/support/settlement-reports-export-faq.md): 加盟店 Portal の Settlement Reports モジュールの仕組み：決済日と精算日のディメンションの選択、エクスポートタイプとその日付範囲の上限、どの通貨セレクターが適用されるか、サマリーにおける Order Amount と Fee Amount の定義、エクスポートが zip に分割されるタイミング、エクスポートタスク一覧の読み方について説明します。
- [精算レポートとエクスポート](https://waffo.com/docs/ja/support/settlement-reports-faq.md): Waffo が精算レポートの各金額をどのように計算するか、各列にどの丸めルールが適用されるか、Settlement History・Settlement Batch・Customized Export の使い方、精算ファイルが存在しない、または空になる理由を説明します。
- [ステーブルコインの例外ケースと返金](https://waffo.com/docs/ja/support/stablecoin-exceptions-faq.md): 購入者が過大に支払った、不足して支払った、期限後に支払った、あるいは誤ったチェーンや誤ったトークンで支払った場合に何が起きるのか — それらのケースをどこで確認でき、どこでは確認できないのか、USDC/USDT の返金が使わなければならない正確なアドレス形式、そしてステーブルコインの返金がオール・オア・ナッシングである理由。
- [ステーブルコイン決済](https://waffo.com/docs/ja/support/stablecoin-payments-faq.md): USDC と USDT の受け入れ：2 つの連携方式のどちらを選ぶか、送信すべき正確なチェーンの値、各方式での受取アドレスの扱い、金額と小数のルール、支払い期限、購入者の送金完了が意味すること・意味しないこと、法定通貨での精算、そしてステーブルコイン注文が Portal のどこに表示されるか。
- [サブスクリプションの金額と期間ごとのスケジューリング FAQ](https://waffo.com/docs/ja/support/subscription-amount-scheduling-faq.md): scheduledAmounts の意味、Waffo が各請求期間の金額をどう決めるか、/subscription/update で変更できること・できないこと（金額の引き下げは可能、引き上げにはプラン変更またはシート追加のトップアップが必要）、金額更新の Webhook、日割り計算のフィールドが存在しない理由。
- [サブスクリプションは実際にいつ課金されますか？](https://waffo.com/docs/ja/support/subscription-billing-schedule-faq.md): Waffo がサブスクリプションの開始から各請求日をどう算出するか、31 日に開始した月次サブスクリプションが 2 月の後に 31 日へ戻る理由、遅れた再試行が次の日付を動かすかどうか、初回期間の失敗が再試行されない理由、そして期間ごとの課金ステータスそれぞれの意味。
- [サブスクリプションの作成・検証 FAQ](https://waffo.com/docs/ja/support/subscription-creation-validation-faq.md): サブスクリプション作成時に Waffo が受け付ける正確な値の範囲、同時に指定が必要なフィールド、サブスクリプションステータスの全一覧と有効な遷移、および作成リトライ、照会、将来の開始日の動作について説明します。
- [クロスカレンシーのサブスクリプションと Portal の FAQ](https://waffo.com/docs/ja/support/subscription-cross-currency-and-portal-faq.md): ある通貨で価格を設定し別の通貨で課金するサブスクリプションで FX がどのように機能するか、換算後の金額とレートがどこで見られるか、マーチャント Portal でサブスクリプション・課金・返金をどのように探すかを説明します。
- [サブスクリプション FAQ](https://waffo.com/docs/ja/support/subscription-faq.md): Waffo のサブスクリプションに関する最もよくある質問への回答：アップグレードとダウングレード、金額の変更、引き落としの失敗とリトライ、通知、トライアル、ユーザー側での管理。
- [ホスト型サブスクリプション管理ページ](https://waffo.com/docs/ja/support/subscription-hosted-management-faq.md): /subscription/manage の仕組み：どのステータスでリンクが返り、なぜ A0028 になるのか、リンクの有効期間と新しいリンクが古いものを無効にするかどうか、顧客がページで正確に何を見て何ができるのか、どこまでブランディングできるのか、そしてページでのキャンセルが即時である理由。
- [サブスクリプションのライフサイクルと決済手段の管理](https://waffo.com/docs/ja/support/subscription-lifecycle-management.md): 将来の日付に開始するサブスクリプションの予約方法、開始前にできること、ユーザーが複数の決済手段を管理しバックアップでの自動リトライを受ける仕組み、金額更新のルール、Waffo がエンドユーザーに送信するライフサイクル通知。
- [ユーザー向けサブスクリプションメール](https://waffo.com/docs/ja/support/subscription-notifications-faq.md): Waffo がサブスクリプション契約者に直接送信できる 6 種類のメール、それぞれが送信される正確なタイミング、どの言語で表示されるか、自社メールとの重複を避ける方法、そしてサブスクリプション請求履歴が返す内容。
- [サブスクリプションプランのアップグレード・ダウングレード](https://waffo.com/docs/ja/support/subscription-plan-change-faq.md): /subscription/change のエンドツーエンドの仕組み：remainingAmount とは何か、誰が計算するのか、4 つの変更ステータス、旧サブスクリプションはいつどうなるのか、顧客が支払わなかった変更を差し替える方法、そして A0048 / A0049 / A0050 / A0054 の意味を説明します。
- [サブスクリプションの再試行と決済手段](https://waffo.com/docs/ja/support/subscription-retry-and-payment-methods-faq.md): サブスクリプションの引き落としが失敗したとき Waffo がどのように再試行するか、いつ再試行をやめ、それがサブスクリプションに何をもたらすか、ローリングの再試行ウィンドウの仕組み、そしてサブスクリプションに紐付く決済手段の登録・並び順・変更・削除のルール全体を説明します。
- [税、割引、Point Topup のエッジケース](https://waffo.com/docs/ja/support/tax-coupon-and-topup-edges-faq.md): 扱いにくいケース：複数回の部分返金にまたがって税がどのように返金され、合計が正確に一致するのか、税計算の失敗がどんなときに注文を止め、どんなときに非課税のまま注文が進むのか、割引レコードの各状態が何を意味し、どの注文イベントがそれを動かすのか、1 件の注文で 2 つの割引を併用できない理由、そして未払いの Point Topup 注文が在庫をどれだけ確保し続けるのか。
- [トークン化とカード決済 FAQ](https://waffo.com/docs/ja/support/tokenization-faq.md): Waffo のカードトークン化に関する最もよくある質問への回答：トークンとは何か、取得方法、トークンのライフサイクル、CIT と MIT の違い、初回決済と後続の課金、期限切れまたは無効なトークンの扱い。
- [カード以外のトークンとトークン失敗の理由](https://waffo.com/docs/ja/support/tokenization-non-card-faq.md): カード FAQ が扱っていないトークナイゼーションの領域：CARD 以外のトークンタイプ、ウォレット系トークンの追加フィールドと固定の有効期限、トークナイゼーションの送信が拒否される理由、カード名義人名のルール、MIT が CIT と異なる挙動、カード決済がどこにも送信される前に拒否される理由、保存済み決済手段のセルフサービス管理。
- [取引・返金フィールドリファレンス](https://waffo.com/docs/ja/support/transaction-field-reference-faq.md): Portal の決済レコードや返金レコードの各フィールドが実際に何を意味するのか：返金に表示される 2 つの加盟店注文 ID、Initiation Type（CIT/MIT）とそれが通常空である理由、カード情報とカード番号のマスク方法、金額がダッシュで表示される理由、返金ボタンが表示されない・グレーアウトしている理由。
- [カード単位の購入数量制限 API](https://waffo.com/docs/ja/support/transaction-limit-api-faq.md): 署名付きの transactionlimit create / update / inquiry エンドポイントを使用して、1 枚のカードが購入できる商品または商品カテゴリの数量に上限を設ける方法：リクエストフィールド、相互排他の 2 つの制限グループ、冪等性、有効期間、ルールに該当した際に購入者に表示される内容を説明します。
- [購入者情報を送信して、チェックアウトで再入力させないようにできますか？](https://waffo.com/docs/ja/support/trusted-shopper-data-faq.md): Waffo チェックアウトにおける信頼済み購入者データ：注文リクエストから事前入力できる 9 つのフィールドはどれか、それでもフォームが表示される理由、購入者が値を編集したときにどちらが優先されるか、CPF のような国民識別番号がその 9 つに含まれない理由、そして設定のスコープと申請方法。
- [Webhook 配信契約 FAQ](https://waffo.com/docs/ja/support/webhook-delivery-contract-faq.md): Waffo が Webhook を配信する際に適用する正確なルール：エンドポイントが応答するまでに許される時間、成功として扱われるレスポンスボディ、各イベントのコールバック URL がどこから来るのか、同じイベントが 2 回届いたり順序が入れ替わったりする理由、そして未入金の通知がどのようなものかを説明します。
- [Webhook イベント辞書と一括再送](https://waffo.com/docs/ja/support/webhook-events-and-resend-faq.md): Merchant Portal が追跡する 7 つの Webhook イベントタイプ、自社注文と照合するために各イベントが持つ識別子、ログの保持期間、そして Retry by Date で失敗した配信を期間指定でまとめて再送する方法。
- [Webhook ペイロードのフィールド FAQ](https://waffo.com/docs/ja/support/webhook-payload-field-faq.md): Webhook のボディのどのフィールドが自社の注文番号なのか、カードの BIN と下 4 桁が実際にはどこにあるのか、送金の手数料フィールドはどれを使うべきか、失敗した課金期間はどう表現されるのか、そして通知のボディが対応する照会レスポンスとどう異なるのかを説明します。
- [出金・残高 API](https://waffo.com/docs/ja/support/withdrawal-and-balance-api-faq.md): 自社システムから精算資金を出金し残高を読み取るための、署名付き 5 エンドポイント：consult → create → inquiry の順序、withdrawRequestId による冪等キー、残高照会が返すアカウント、アカウント履歴照会の時間範囲とフィールド。
- [出金・一括送金 FAQ](https://waffo.com/docs/ja/support/withdrawal-and-batch-payout-faq.md): Waffo 加盟店 Portal から精算資金を出金する方法と一括送金（Batch Payout）に関するよくある質問への回答：手数料、ステータス、ステートメント、受取人口座、バッチ検証、自動出金。
- [出金の例外とステータス](https://waffo.com/docs/ja/support/withdrawal-exceptions-and-status-faq.md): 出金が審査で却下された、銀行に拒否された、あるいは成功後に返却された場合に何が起こるか：ステータスの全体像、出金手数料が戻るかどうか、返却が生成する口座履歴の行、各状態で Description 列に表示される内容、そして Withdraw ボタンがグレーアウトする理由。