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

# 決済と精算における為替レート

> 異通貨の注文がどのレートを使うのか、レートはいつ提示・再提示されるのか、なぜ UTC+8 の日中に現地通貨の金額が変わるのか、適用されたレートは API と Portal のどこに表示されるのか、そして精算と返金はそれぞれどのようにレートを選ぶのかを説明します。

[金額と通貨](/docs/ja/developer-docs/core-concepts/currency) では、Waffo が異通貨の注文を自動的に換算すると述べています。
このページはその一文の裏側にある仕組みです。どのレートが、いつ提示され、どこで確認でき、精算時と返金時に何が起きるのか。

## 異通貨の注文はどの為替レートを使いますか？

`orderCurrency` が顧客が実際に支払う通貨と異なる場合、その注文は異通貨注文です。Waffo は価格算定対象の決済手段について、
その通貨ペア — 注文通貨を基準通貨、支払い通貨を相手通貨として — のレートを提示し、契約で合意したマークアップを適用します。

```
payable amount = orderAmount × base rate × (1 + contracted markup)
```

その結果は、支払い通貨と決済手段が受け付ける単位に**切り上げ**られます — 一部の決済手段は整数倍や固定の小数桁数しか
受け付けません — そして端数調整の差額は、レートに織り込まれるのではなく、別の調整要素として保持されます。

## 現地通貨の金額が午前と午後で異なるのはなぜですか？

標準の日次レートが暦日ベースのレートではないためです。各レートの期間は 1 日ですが、\*\*深夜 0 時ではない
1 日のうちの固定時刻（UTC+8）\*\*に切り替わるため、切り替え前に価格算定された注文と切り替え後の注文は、
同じ暦日であっても同じ通貨ペアに対して異なるレートを使います。

2 つの補足があります。提示されるすべてのレートは独自の有効期間と失効時刻を持つため、日次の切り替えは通常の更新時点であって、
期間内にレートが置き換えられないことの保証ではありません。また、契約上のマークアップはレートの期間とは独立して、
独自の発効日で管理されます。

## レートは固定されますか？固定されるならどれくらいの期間ですか？

購入や有効化ができるレート固定（レートロック）の商品はありません。存在するのはスナップショットです。

* レートは**支払金額が価格算定されたときに**提示され、レート参照とその失効時刻とともに注文に保存されます。
* 支払金額が**チェックアウトで再計算される**場合 — たとえばプロモーションコードで注文金額が変わる、または購入者が
  決済手段を切り替える — その時点で為替が再提示されます。購入者が送信したときに表示されていた金額が請求金額です。
* 認可済みの注文に対する後の**キャプチャ**は、注文に保存されたレートを再利用します。再提示はされません。

## Waffo には為替レートの照会エンドポイントがありますか？

ありません。レート見積りのエンドポイントも、レート固定のエンドポイントも、アクセスを申請できる別の為替ロックサービスも
存在しません。それらを前提に構築しないでください。レートは注文の一部としてお客様に届きます。

| 知りたいこと | 使うもの |
| - | - |
| 1 つの注文に適用されたレート | 作成レスポンスの `orderAction.actionData.exchangeRate`、または `POST /api/v1/order/inquiry` |
| 顧客が支払う金額 | 同じ `actionData` の `paymentAmount` / `paymentCurrency`、または照会時の `finalDealAmount` |
| 多数の取引にわたるレート | API 呼び出しではなく、Portal の精算レポートとエクスポート |

## `exchangeRate` フィールドが 2 つあります。それぞれ何ですか？

| フィールド | 誰のレートか | 読み方 |
| - | - | - |
| `orderAction.actionData.exchangeRate` | この注文に対する Waffo の適用レート | 注文通貨と支払い通貨が異なる場合、`paymentAmount ÷ orderAmount` として文書化されている |
| `payMethodInfo.exchangeRate` | 顧客の支払い中に決済手段自身が使ったレート | 参考情報 — ウォレットや銀行が自側で使ったもので、`userPaymentAmount` / `userPaymentCurrency` とともに返される |

顧客負担のサービス手数料が適用される場合、それは `userFeeAmount` / `userFeeCurrency` として別途返されます。
2 つの金額の比率を純粋な為替レートと見なす前に、これを考慮してください。

## Portal ではどこでレートを確認できますか？

| Portal の場所 | フィールド | 対象 |
| - | - | - |
| 取引詳細 | `Payment Amount` とその通貨 | 顧客向けの金額。レートのフィールドはなく、注文金額との比較でレートが暗示される |
| Settlements → Estimation | `Forex Currency Pair`、`Est. Forex Rate` | まだ精算されていない注文の**推定**換算 |
| Settlements → Settlement Batch | `Exchange rate`（*元金額 = 換算後金額* の形式で表示） | 注文通貨ごとに実際に実行された換算 |
| 精算レポート | `Forex Currency Pair`、`Forex Rate` | 取引ごと。バッチ詳細とカスタマイズしたエクスポート |

Estimation はメニュー権限で制御されるページです。Portal のナビゲーションに表示されていれば、お客様のアカウントで利用可能です。
その数値に `Est.` の接頭辞が付いているのには理由があります — 精算実行前に計算されるため、まだ変動する可能性があります。

## 精算は注文のレートで換算されますか？

いいえ。精算の換算は独自のレートを持つ**別のイベント**で、精算が処理されるときに適用されます — 注文に保存されたレートではありません。
そのため、`Settlement Original Amount`（注文通貨でネットした金額）と `Settlement Target Amount`（同じ資金の換算後）は
バッチ上で異なる通貨になり、換算が完了するまで換算後金額は空欄です。

注文通貨が精算通貨とすでに一致している精算行にも `Forex Currency Pair` が表示されることがあります。手数料と税が第三の通貨で
請求されることがあるためです。通貨ペアは固定の優先順位で解決され、ペアが空欄のときは `Forex Rate` も常に空欄です —
いずれも [精算レポートとエクスポート](/docs/ja/support/settlement-reports-faq) に記載されています。

## 返金はどのレートを使いますか？

常に**元の注文に保存されたレート**であり、新たな提示は決して使われません。支払いと返金の間でレートが動いても、
顧客に戻る現地通貨の金額は変わりません。

| 返金 | 顧客向け金額の導出方法 |
| - | - |
| 全額返金 | 元の支払金額から、顧客負担の手数料と税の要素を除いたもの |
| 一部返金 | 返金される注文金額を、注文の為替のみのレートで比例換算したもの |

返金額は支払い通貨の精度に**切り捨て**られます — 注文の価格算定とは逆方向です — そのため返金が元の支払金額を超えることは決してなく、
換算後の金額がゼロに丸められる返金は送金されずに拒否されます。複数回の一部返金にわたる端数処理のルールは
[返金 FAQ](/docs/ja/support/refund-faq) にあります。

***

特定の数値を照合していますか？注文 ID を添えて [サポートにお問い合わせください](mailto:support@waffo.com) —
適用レート、支払金額、端数調整はすべてその注文に紐づけて保存されています。


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