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

# Payout ウォレットと対応範囲

> 4 つ目の Waffo アカウント：Payout ウォレットが保持するもの、資金がどのように入り、出ていくか、失敗・取消となった Payout がどのように精算アカウントに戻るか、独立した Account History の読み方、そしてどの Payout コリドーを契約しているかをどこで確認するか。

Waffo の 4 つの残高のうち 3 つは資金の回収に関するものです。資金の支払いには、独自の台帳を持つ
4 つ目のアカウントを使用します。このページでは、そのアカウントと、契約している支払い先をどこで
確認するかを説明します。Payout の作成と追跡については Payout FAQ を参照してください。

## Payout ウォレットとは何ですか？精算アカウントとどう違うのですか？

精算アカウントから出たものの、まだ受取人に届いていない資金を保持します。Portal ではこの残高を
**In Transit** と表示します。

| アカウント | Portal メニュー | 保持するもの | 出金可能？ |
| - | - | - | - |
| 精算待ち | Settlement Account | まだ精算されていない成功取引 | いいえ |
| 精算アカウント | Settlement Account | 精算済みの資金（精算通貨ごと） | はい |
| Reserve | Reserve Account | 契約に基づき留保されている金額 | いいえ |
| **Payout ウォレット** | **Payout Wallet** | 処理中の Payout に充てられた資金 | **いいえ** |

ウォレットには出金操作がなく、出金元にもなりません——出金は精算アカウントからのみ行われます。
ウォレットは、処理中の Payout 資金が精算残高から単に消えるのではなく、見える状態のまま残るように
するために存在します。

## ウォレットの資金はどこから来るのですか？

同じ署名主体の下にあるお客様の**精算アカウント**から、Payout が**送信された**時点で移動します——
完了した時点ではありません。影響は 2 点です：

* **通貨は契約の支払者通貨**であり、受取人が受け取る通貨ではありません。通貨をまたぐ Payout は
  まず支払者通貨に換算されるため、ウォレットとその履歴は Service → Payout ページに表示される
  **Currency Pair** の資金供給側の通貨で表示されます。
* **金額には Payout 手数料が含まれます**——資金供給額 = 換算後の Payout 金額 + その注文の手数料。
  このため、ウォレットの行が Payout 金額と正確に一致することはほとんどありません。

資金供給通貨の精算残高が不足している場合、単一の Payout はキューに入るのではなく、作成時に
残高不足の業務エラーで拒否されます。

## Payout ウォレットページには何が表示されますか？

2 つのタブがあります：**Payout Wallet** はウォレット通貨ごとに 1 枚のカードで **In Transit** 残高を
表示し、**Account History** はその台帳です。ウォレットアカウントは必要になった時点で初めて
作成されるため、ページが空であれば Payout の資金供給がまだ一度も実行されていないということです。
このページは有効化されたアカウントで利用できます——メニューに表示されていれば、お使いいただけます。

ここでの Account History は **Payout ウォレットのみ**を対象とし、Settlement Account 配下の Account
History とは別です：1 件の Payout は両方に行を生成し、どちらも他方の行は表示しません。

各行には **Account No**、**Business ID**（単一 Payout の場合は `payoutOrderId`、バッチ Payout の
場合はバッチ ID）、**Business Type**——このページでは常に *Payout*——**Direction**（ウォレットへの
*Credit*、ウォレットからの *Debit*）、方向に応じた符号付きの小数点以下 2 桁の **Amount**、UTC+8 の
**Datetime**、そしてその行が Payout のどの段階かを示す **Description** が含まれます。

日付フィルターのデフォルトは**過去 1 か月**で、フリーテキストの **Business ID** 検索があります。
エクスポートは **31 日**の範囲に制限され、ブラウザとサーバーの両方で強制されます。ファイルは
`payout_account_history_{merchant id}_{start}_{end}.csv` で、タイムスタンプは UTC+8 の
`YYYYMMDDHHMMSS`、さらに画面上のテーブルにない 2 つの列が追加されます：**Account Type** と
**Balance**（その資金移動直後の残高）。

## Description の値はそれぞれどういう意味ですか？

行はペアで現れ、そのペアが資金がどの段階にあるかを教えてくれます。

| Description | 意味 |
| - | - |
| **Payout Funding In** | 送信時に、精算アカウントからウォレットに資金供給された |
| **Payout Funding Out** | 送信時に、ウォレットから Payout に向けて解放された |
| **Payout Failed In** | Payout が失敗の最終ステータスに達し、資金がウォレットに戻る |
| **Payout Failed Out** | その資金がウォレットを離れ、精算アカウントに戻る |
| **Payout Reverse In** / **Out** | 成功後に取消された Payout に対する同等のペア |

資金供給の 2 行は送信時に同時に記帳されるため、すべての Payout が最終ステータスに達した
ウォレットは、長い履歴があっても In Transit 残高がゼロであることが正当にあり得ます。

## Payout が失敗しました。手数料も戻ってきますか？

Payout 金額は常に戻ります。手数料はどこで失敗したかによります：注文が Payout チャネルに一度も
到達しなかった場合、手数料は全額返還されます。チャネルに到達した後に失敗した場合、手数料は契約が
**Fee Refundable = Yes** とマークされている場合にのみ戻ります——これは Service → Payout ページの列で、
送信前に決済手段ごとに確認できます。返還不可の場合、戻る金額は資金供給額**から手数料を差し引いた額**
となり、注文の手数料ステータスは差し引き済みと表示されます。

## 成功した Payout が取消された場合、何が起きますか？

Payout は、すでに `SUCCESS` に達した後に受取側から返送されることがあります。Waffo は `status` を
`SUCCESS` のままにし、`FULL_REVERSED` または `PARTIAL_REVERSED` の `subStatus` を追加します。
取消された金額は、その Payout に資金を供給したアカウント——お客様の精算アカウント——に資金供給通貨で
戻されます。一部取消では取消された部分のみが戻るため、元の Payout 金額ではなく取消金額に対して
照合してください。

## どの国、決済手段、受取人タイプに Payout できますか？

参照できるグローバルなリストはありません：対応範囲は契約ごとであり、お客様の対応範囲は Portal の
**Service → Payout** にあります。各行は契約済みの組み合わせ 1 つで、**Country/Region**、
**Currency Pair**（支払者通貨 → 受取人通貨）、**Payment Method Type** と **Payment Method**、
**Payment Option**、**Fees**、**Minimum Amount** と **Maximum Amount**（支払者通貨）、
**Fee Refundable**、**Validity Period**（契約の開始と終了）、**Status** が含まれます。フィルターは
国、決済手段タイプ、決済手段、ステータスをカバーします。**Status** は **Initial**、**Active**、
**Suspended**、**Terminated** のいずれかで、取引できるのは *Active* のみです——契約外として
拒否された Payout は通常 Active でない契約によるもので、Validity Period を見れば単に期限が切れた
だけかどうかがわかります。

受取人タイプはリクエストごとに `payeeType` = `INDIVIDUAL` または `BUSINESS` で設定します。
特定の決済手段が個人、法人、または両方を受け付けるかは、ページの列ではなく契約の一部であるため、
決済手段がどちらか一方を拒否する場合はサポートに確認してください。

## Service → Payin はどう読めばよいですか？一部の列が表示されないのはなぜですか？

契約済みの決済手段ごとに同じ考え方です：**Payment Method Country**、**Product**、**Payment Method
Type**、**Payment Method**、**Payment Option**、**Fees**、**User Fee**（エンドユーザーに課される
手数料）、**Settlement cycle**、**Minimum**/**Maximum Amount**、**Order Currency**（契約上の
アクワイアリング通貨）、**User Currency**（支払者に請求される通貨）、**Refundable**、**Refund
Period**、**Additional Fields For Refunds**、**Status**——さらに直接の **Export** があります。

一部の列は条件付きであり、これが 2 つのアカウントで異なるテーブルが表示される理由です：**User Fee**
は契約がユーザー手数料を課す場合にのみ表示され、その場合 Refundable セルにそのユーザー手数料が
返金可能かどうかも記載されます。**Mini Apps Info** は契約にミニプログラムアプリが紐づいている場合
のみ、**Order Expiry Customization** はお客様のアカウントに適用される場合のみ表示されます。**Fees**
と **Settlement cycle** はゲートウェイモデルのアカウントでは非表示です。

**Refundable** は API が `refundAllowed` として返す値と同じものを読み解いたものです：*No*、
*Only Full Refund*、*Full Refund or One-time Partial Refund*、または *Full Refund or Multiple Partial
Refunds*。複数回返金のロジックを構築する前に確認してください。Payin のステータスには上記 4 つに
**Onboarding** が加わります。チェックアウト画面に決済手段が表示されない場合、通常は Active でない
契約が原因です。

***

ウォレット履歴と精算台帳が一致しませんか？
Business ID 列の `payoutOrderId` またはバッチ ID を添えて
[サポートにお問い合わせください](mailto:support@waffo.com)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.