> ## 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 アカウントで通貨と決済手段が利用可能になる仕組み：注文通貨とユーザー通貨の違い、有効化されている内容をどこで確認するか、有効化されていない通貨が実際に返すエラー、有効化が加盟店 ID 単位かアカウント全体か、同じ決済手段をある市場では現地通貨で別の市場では USD で価格設定できるか、決済手段の追加が稼働中のものに影響するか。

結論から言うと、**「この通貨を有効化する」という独立したスイッチは存在しません。** 通貨は、
お客様の決済手段契約のいずれかに載っていれば利用可能です。したがって「私の通貨は有効化されて
いますか？」と「私はこの決済手段を有効化されていますか？」は、同じ質問を 2 回している
ことになります。このページでは、その帰結を順に説明します。誰もがつまずくエラーコードも含めて。

金額のフォーマット、小数点以下の桁数ルール、通貨の全一覧は、公開済みの
[通貨の取り扱い](/docs/ja/developer-docs/core-concepts/currency) にあります。価格設定の戦略そのものは
[価格設定と通貨](/docs/ja/developer-docs/use-cases/pricing-currency) にあります。注文の複数の金額項目の
うちどれを検証し、出荷の根拠とし、照合すべきか——そして `finalDealAmount` が `orderAmount` と
正当に異なる理由——は
[どの金額と通貨の項目を確認すればよいですか？](/docs/ja/support/order-amount-and-currency-fields-faq)
にあります。以下は項目やフォーマットではなく、有効化についての説明です。

## 注文には、どの 2 つの通貨がありますか？

すべての Payin 契約は両方を持っており、それぞれ異なる役割を果たします。

| 通貨 | 何か | どこで送るか |
| - | - | - |
| **注文通貨** | お客様が価格を設定し、会計処理を行う通貨 | 注文作成時の `orderCurrency` |
| **ユーザー通貨** | 支払者が実際に請求される通貨 | `userCurrency`、任意 |

2 つが同じ場合、注文は同一通貨です。異なる場合は通貨をまたぐ注文となり、為替レートが
適用されます——[為替レート](/docs/ja/support/exchange-rates-faq) を参照してください。

この区別が有効化において重要なのは、**それぞれが別々にチェックされる**ためです。契約は
注文通貨を含んでいなければならず、さらに——ユーザー通貨をご自身で固定する場合——
そのペアも契約されていなければなりません。

## 利用できる通貨はどこで確認できますか？

同じ設定を見る 3 つの方法があります。

| 表示 | 表示内容 |
| - | - |
| Portal の **Service → Payin** | 契約済みの組み合わせごとに 1 行、`Order Currency` 列と `User Currency` 列付き |
| `POST /api/v1/paymethodconfig/inquiry` | 同じ内容をコードから取得——契約ごとに 1 エントリ、それぞれ `currency` と `orderAmountMin` / `orderAmountMax` 付き |
| 公開済みの[決済手段](/docs/ja/essentials/payment-methods) | 各決済手段が一般的に提供されている決済通貨——計画には有用ですが、お客様のアカウントについての記述では**ありません** |

「今日これができるか」に答えるには最初の 2 つを使い、それ以外は使わないでください。列ごとの
読み方は [Payin 契約と取引上限](/docs/ja/support/payin-agreements-and-limits-faq) に、
レスポンスの項目は
[決済手段の設定と上限](/docs/ja/support/payment-method-config-and-limits-faq) にあります。

## ある決済手段は USD を受け付けますか、それとも現地通貨のみですか？

それは決済手段ではなく、行によって決まります。同じ決済手段が複数の注文通貨で契約されることが
あり、Service → Payin に同じ決済手段が複数回——通貨ごとに 1 行——それぞれ異なる上限で
表示されるのは正常です。

したがって、この問いは行ごとに答えられます：決済手段を見つけ、その `Order Currency` を読み、
支払者への請求通貨を固定するつもりであれば `User Currency` も読んでください。ある市場から
別の市場へ一般化せず、連携側で答えをキャッシュしないでください——inquiry 呼び出しから
読み取ってください。

## 契約していない通貨を送信しました。どのエラーが返りますか？

**`A0018`** — *"Payment method in merchant order does not match with current merchant contract."*
通貨固有のコードではありません。これは通貨の有効化について最も誤解を招く点です：メッセージは
決済手段について述べていますが、拒否の原因は完全に通貨にあるかもしれません。

通貨に起因して `A0018` が返る 3 つのパターン：

| 送信した内容 | 失敗する理由 |
| - | - |
| お客様のいずれの契約にもない `orderCurrency` | 検索は注文通貨に完全一致で照合します。何も一致しないため、残る契約がありません |
| その決済手段に対して契約されていない `userCurrency` | ユーザー通貨の次元も同様に完全一致で照合されます |
| レートを適用できない通貨ペア | 契約は存在しますが、注文の価格を算出できません |

`A0018` を「決済手段が間違っている」と読むと、誤った箇所を確認することになります。
「**私のどの契約もこのリクエスト全体に一致しなかった**」と捉え、次元ごとに確認してください——
[注文が拒否されたとき、何を確認すればよいですか？](/docs/ja/support/order-rejection-self-diagnosis-faq)
を参照してください。

## 通貨ペア版のこのエラーを避けるにはどうすればよいですか？

**`userCurrency` を省略してください。** 固定しなければ、チェックアウト画面が支払者への請求通貨を
解決し、注文金額を現在のレートで換算するため、注文通貨側だけが契約されていれば十分です。
`userCurrency` は、支払者向けの通貨をご自身で固定する理由がある場合にのみ、かつ
Service → Payin で確認できるペアに対してのみ送信してください。

同じコードについての決済手段側からの既存のガイダンスは
[よくあるエラーのトラブルシューティング](/docs/ja/support/errors-troubleshooting-guide) に、
支払者が最終的にどの通貨で請求されるか、そしてそれがなぜ予想外になり得るかは
[チェックアウト画面のリダイレクトとアクション種別](/docs/ja/support/cashier-redirect-and-action-type-faq)
にあります。

## ある市場では現地通貨で、別の市場では USD で価格設定できますか？

はい。価格設定は契約の行に存在し、行は国ごと・通貨ごとなので、異なる市場を異なる形で
設定できます——一部では現地通貨での価格設定、他では単一のグローバル通貨——同じ決済手段
についても同様です。すべての市場に 1 つの選択を強制するアカウント全体の設定はありません。

できないのは、リクエストごとに決めることです：お客様は、いずれかの行が持つ `orderCurrency`
を送信します。ある市場が現地通貨のみで契約されている場合、その市場向けに USD で価格設定した
注文は `A0018` となり、修正はパラメーターの変更ではなく契約の変更です。

3 つの価格設定の形と、それぞれが含意するパラメーターは、公開済みの
[価格設定と通貨](/docs/ja/developer-docs/use-cases/pricing-currency) にあります。

## 資金が精算される通貨も同じものですか？

いいえ——精算通貨は第 3 の独立した次元であり、Payin 契約ではなく精算設定で構成されます。
注文はある通貨で価格設定され、支払者には第 2 の通貨で請求され、お客様には第 3 の通貨で
精算されることがあります。
[精算アカウントの構造](/docs/ja/support/settlement-account-structure-faq) と
[精算計算の解説](/docs/ja/support/settlement-calculation-explained) を参照してください。

## 決済手段はアカウント全体で有効化されますか、それとも加盟店 ID ごとですか？

**加盟店 ID ごとです。** 契約は 1 つの加盟店 ID に属し、注文作成はリクエストに署名した
加盟店 ID の契約を検索します。したがって、ある加盟店 ID で決済手段を有効化しても、別の
加盟店 ID では有効化されません。複数の加盟店 ID を運用している場合——事業ラインごと、
地域ごとなど——依頼の際には、それが必要なすべての加盟店 ID を挙げてください。

実務上の帰結：

* ある加盟店 ID では成功する同じリクエストが、別の加盟店 ID では `A0018` を返すことがあります。
  ペイロードを疑う前に、お客様の APIキーがどの加盟店 ID に属しているか確認してください。
* Service → Payin と inquiry 呼び出しは、常に一度に 1 つの加盟店 ID についてのみ回答します。
* 加盟店 ID を挙げたパラメーターエラーが返った場合、不一致はボディ内の ID とキーが属する ID の
  間にあります——
  [決済手段の設定と上限](/docs/ja/support/payment-method-config-and-limits-faq) を参照してください。

## 国ではなく地域単位で有効化してもらうことはできますか？

契約の行の次元は**国**であり、加えて、特定の 1 国に属さない決済手段のための独立した
**Global** エントリがあります。その間に地域という単位はないため、「ヨーロッパ」や「日本と韓国」
は、必要な国の集合として表現され、それぞれが独自の行になります。

これはロールアウトを計画する際に知っておく価値があります：地域名ではなく国の一覧を依頼し、
結果として得られる Service → Payin ページは、地域ごとに 1 行ではなく、国と通貨の組み合わせごとに
1 行になると想定してください。

## 決済手段を追加すると、すでに稼働中のものに影響しますか？

いいえ、ダウンタイムも発生しません。契約は独立した行です：追加すると新しい行が作成され、
既存の行のステータス、上限、返金ルールはそのまま維持されます。新しい決済手段の設定中も、
すでに運用中の決済手段のライブトラフィックには影響しません。

お客様側でも、何も変更する必要はありません——新しい決済手段を明示的に指定したい場合を
除いて。契約済みのものをチェックアウト画面にそのまま表示させている場合、新たに `Active`
になった行が単に表示され始めます。`payMethodName` / `payMethodType` をご自身で渡している
場合は、新しい値をいつから送り始めるかをお客様が決めます。新しく契約した決済手段が
チェックアウト画面のどこに表示されるかは
[チェックアウト画面の表示ルール](/docs/ja/support/cashier-display-rules-faq) に、依頼がどのように
進むかは [決済手段の申し込み](/docs/ja/support/payment-enrollment-faq) にあります。

## サンドボックスで見た上限と通貨は、本番環境でも同じですか？

いいえ——サンドボックスで読み取った内容を本番環境の値や見積もりとして扱ってはいけません。
本番環境の値は、本番環境の Portal から、または本番環境の認証情報で
`/api/v1/paymethodconfig/inquiry` を呼び出して読み取り、注文を作成する前にそれらに対して
検証してください。サンドボックスの数値がなぜ存在するのか、それが何の証拠であり何の証拠では
ないのかは、[サンドボックス環境とアクセス](/docs/ja/support/sandbox-environment-and-access-faq)
にあります。

手数料は商業条件であり、お客様自身の Payin ページにのみ表示されます——どこにも公開されて
いません。


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