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

# 残高と口座履歴

> Waffo の 3 つの残高（精算待ち、精算アカウント、Reserve）の読み方、出金可能額が精算残高より少なくなる理由、Account History に記録される内容、Statement と Invoice の PDF の命名規則。

貴社が得た資金は、銀行口座に届くまでの間、複数の場所に置かれます。このページでは、各残高、その背後にある台帳、および照合に使う書類について説明します。精算サイクル自体については、
[加盟店精算](/docs/ja/essentials/merchant-settlement) をご覧ください。

## Waffo にはどのような残高が表示され、それぞれ何を意味しますか？

| 残高 | 内容 | 出金可能か？ |
| - | - | - |
| **精算待ち**（未精算 / 精算予定） | 成功した取引のうち、まだ精算日に達していない資金。返金とチャージバックはまずここでネットされます。 | いいえ — 先に精算される必要があります。 |
| **精算アカウント** | 精算が完了した資金。精算通貨ごとに保持されます。 | はい。ただし下記のチェックの対象です。 |
| **Reserve** | 契約に基づいて留保された金額：`Reserve balance = Reserve per contract + Reserve adjustment`。 | いいえ。 |

残高と精算バッチは**精算通貨別**に表示され、FX 換算は資金が精算アカウントに入る前に完了します。出金時に行われることはなくなりました。

## 出金可能額が精算アカウント残高より少ないのはなぜですか？

Reserve を満額に保つ必要があるためです。Reserve残高が必要額を満たしている場合、出金可能額は精算アカウント残高と等しくなります。満たしていない場合は、精算アカウント残高**から不足分を差し引いた額**となり、その差額は Reserve が補充されるまで留保されます。Reserve が取り崩された場合、Waffo は「使用された分だけを正確に戻す」方式で、引き落とし後の次の処理サイクルにおいて貴社の精算アカウントから補充します。これは Account History に `RESERVE_ADJUSTMENT`、備考 *Debit from settlement account* として表示されます。

## Reserve には何が含まれますか？Reserve から返金できますか？

Reserve が適用されるかどうか、およびその種類は契約で定義されます。**固定 Reserve**（契約期間中に留保される一定額）と、**ローリング Reserve**（各精算の純額の一定割合を契約上の保持期間にわたって留保するもの）があります。両方が適用されることもあり、徴収は決済手段ごとにオン・オフを切り替えられます。貴社の `Reserve Ratio` と `Reserve Period` は、加盟店 Portal の Payin 契約ページにあります。

* **Reserve から返金されることはありません。** 返金は精算待ち残高のみから引き落とされ、マイナスの精算は Reserve に課されるのではなく繰り越されます。
* **純額がマイナスの精算日には留保は発生しません。** 純額がプラスとなる次の精算日に加算されます。
* 保持期間は、**契約の定めに従い、営業日または暦日**でカウントされます。営業日が適用される場合、固定の Reserve カレンダーに基づいて計算されます。これは精算日をずらすカレンダーとは別のものです。留保は、その日にまだ必要とされる金額をReserve残高が上回っている場合にのみ、予定解放日に解放されます。同額以下の場合、残高が回復するまで何も解放されません。詳細は
  [Reserve口座](/docs/ja/support/reserve-faq) をご覧ください。

Reserve の動きは、独立した **Reserve Account** モジュールにあります：Reserve残高合計、*Reserve per contract*（留保と解放）、*Reserve adjustment*（引き落としと補充）です。**Settlement Account** と表示される精算台帳には、これらは混在しなくなりました。精算カレンダーには **Reserve Release Date** が表示されます。

## Account History には何が記録されますか？ビジネスタイプにはどのような種類がありますか？

Account History は、すべての精算通貨における貴社アカウント上の資金移動の台帳です。表示されるアカウントは、どこから参照するかによって異なります。

| 参照先 | 範囲 |
| - | - |
| Portal **Account → Balance → Balance History** | 貴社の**精算アカウント** |
| Portal **Reserve Account** モジュール | 貴社の**Reserve口座** — 留保、解放、調整 |
| `/api/v1/account/history/inquiry` | **両方**のアカウント。`accountType` を省略すると両方が返されます |

各行には Account No、Account Type、Business Id、Business Type、Direction、Amount / Currency、Balance（その資金移動直後の残高）、Datetime、Description が含まれます。

フィルター可能なビジネスタイプは次のとおりです。

| ビジネスタイプ | 内容 |
| - | - |
| `SETTLEMENT` | 精算アカウントへの入金となる精算 |
| `WITHDRAWAL` | 精算アカウントからの引き落としとなる出金 |
| `ADJUSTMENT` | 手動による訂正 |
| `RESERVE_WITHHOLDING` | Reserve に移された資金 |
| `RESERVE_RELEASING` | Reserve から解放されて戻った資金 |
| `RESERVE_ADJUSTMENT` | 取り崩された Reserve を貴社の精算アカウントから復元する補充 |

FX の `Conversion` 行は表示されなくなりました。換算は出金時ではなく出金前に行われるようになったためです。古い行にはこのラベルが残っている場合があるため、履歴を照合する際はフィルターなしで一覧を読んでください。フィルター値とその下にあるアカウント構造は
[精算アカウント構造](/docs/ja/support/settlement-account-structure-faq) で扱っています。

デフォルトでは直近 **30 日**分が新しいものから順に表示され、同一タイムスタンプの行は通貨の A–Z 順で並びます。精算レコードはデフォルトで直近 **90 日**分です。どちらの期間も UTC+8 です。

## 返金とチャージバックはどの残高から引き落とされますか？マイナスになることはありますか？

返金は**精算待ち**残高からネットされます。チャージバックとチャージバック手数料は、固定の順序で試行されます：精算待ち残高 → 精算アカウント残高 → **当座貸越として**精算待ち残高。最後の段階ではマイナスになることがあり、後続の入金資金によって解消されます。Payin 加盟店アカウントはデフォルトで当座貸越可能です。

精算日の純額がマイナスの場合（返金とチャージバックが決済を上回る場合）、その日は資金は移動せず、マイナス額は純額がプラスとなる次の精算日に繰り越されます。精算待ち残高が不足していたために実行できなかった精算は、後続の精算日に、最も古い日付かつ最も大きい金額から順に、最小のものさえ充当できなくなるまで再試行されます。

## Statement と Invoice の PDF はどのように命名され、何が含まれていますか？

| 書類 | ファイル名 |
| - | - |
| Settlement Statement | `settlement_statement_{merchant id}_{currency}_{date}.pdf` |
| Withdrawal Statement | `{merchant id}-{withdraw order id}_{account type}.pdf`（再生成時はタイムスタンプが付加されます） |
| Invoice | `invoice_{currency}_{date1}_{date2}.pdf` |

日付は `YYYYMMDD` です。3 つの書類はいずれも同じ 4 ブロックのレイアウトを共有します：発行元 Waffo エンティティの名称と住所、書類ブロック（日付と番号）、貴社の会社名と住所、そしてビジネス明細表です。`Total` は表内の行として現れることはなく、表の下に別途記載されます。金額は桁区切り記号と小数 2 桁を使用し、通貨を前に置きます（`{Currency} {Amount}`）。Country/Region は ISO 3166-1 alpha-3 コード（`USA`、`CHN`、`HKG`）を使用します。

Settlement Statement の列は Country/Region、Transaction Amount、Fee Amount、Tax Amount、Avg. Forex Rate、Settlement Amount と合計です。Withdrawal Statement ではレート列は **Forex Rate** という名称で、換算がなかった場合は列が省かれるのではなく `--` が表示されます。Reserve の留保は精算ファイルにも Statement にも表示されません。これらは精算後に徴収され、Settlement Batch 一覧と Reserve Account モジュールから照合します。
[Reserve口座](/docs/ja/support/reserve-faq) をご覧ください。


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