finalDealAmount が orderAmount と
正当に異なる理由——は
どの金額と通貨の項目を確認すればよいですか？
にあります。以下は項目やフォーマットではなく、有効化についての説明です。
注文には、どの 2 つの通貨がありますか？
すべての Payin 契約は両方を持っており、それぞれ異なる役割を果たします。
2 つが同じ場合、注文は同一通貨です。異なる場合は通貨をまたぐ注文となり、為替レートが
適用されます——為替レート を参照してください。
この区別が有効化において重要なのは、それぞれが別々にチェックされるためです。契約は
注文通貨を含んでいなければならず、さらに——ユーザー通貨をご自身で固定する場合——
そのペアも契約されていなければなりません。
利用できる通貨はどこで確認できますか？
同じ設定を見る 3 つの方法があります。
「今日これができるか」に答えるには最初の 2 つを使い、それ以外は使わないでください。列ごとの
読み方は Payin 契約と取引上限 に、
レスポンスの項目は
決済手段の設定と上限 にあります。
ある決済手段は USD を受け付けますか、それとも現地通貨のみですか？
それは決済手段ではなく、行によって決まります。同じ決済手段が複数の注文通貨で契約されることが あり、Service → Payin に同じ決済手段が複数回——通貨ごとに 1 行——それぞれ異なる上限で 表示されるのは正常です。 したがって、この問いは行ごとに答えられます：決済手段を見つけ、そのOrder Currency を読み、
支払者への請求通貨を固定するつもりであれば User Currency も読んでください。ある市場から
別の市場へ一般化せず、連携側で答えをキャッシュしないでください——inquiry 呼び出しから
読み取ってください。
契約していない通貨を送信しました。どのエラーが返りますか？
A0018 — “Payment method in merchant order does not match with current merchant contract.”
通貨固有のコードではありません。これは通貨の有効化について最も誤解を招く点です：メッセージは
決済手段について述べていますが、拒否の原因は完全に通貨にあるかもしれません。
通貨に起因して A0018 が返る 3 つのパターン：
A0018 を「決済手段が間違っている」と読むと、誤った箇所を確認することになります。
「私のどの契約もこのリクエスト全体に一致しなかった」と捉え、次元ごとに確認してください——
注文が拒否されたとき、何を確認すればよいですか？
を参照してください。
通貨ペア版のこのエラーを避けるにはどうすればよいですか？
userCurrency を省略してください。 固定しなければ、チェックアウト画面が支払者への請求通貨を
解決し、注文金額を現在のレートで換算するため、注文通貨側だけが契約されていれば十分です。
userCurrency は、支払者向けの通貨をご自身で固定する理由がある場合にのみ、かつ
Service → Payin で確認できるペアに対してのみ送信してください。
同じコードについての決済手段側からの既存のガイダンスは
よくあるエラーのトラブルシューティング に、
支払者が最終的にどの通貨で請求されるか、そしてそれがなぜ予想外になり得るかは
チェックアウト画面のリダイレクトとアクション種別
にあります。
ある市場では現地通貨で、別の市場では USD で価格設定できますか？
はい。価格設定は契約の行に存在し、行は国ごと・通貨ごとなので、異なる市場を異なる形で 設定できます——一部では現地通貨での価格設定、他では単一のグローバル通貨——同じ決済手段 についても同様です。すべての市場に 1 つの選択を強制するアカウント全体の設定はありません。 できないのは、リクエストごとに決めることです：お客様は、いずれかの行が持つorderCurrency
を送信します。ある市場が現地通貨のみで契約されている場合、その市場向けに USD で価格設定した
注文は A0018 となり、修正はパラメーターの変更ではなく契約の変更です。
3 つの価格設定の形と、それぞれが含意するパラメーターは、公開済みの
価格設定と通貨 にあります。
資金が精算される通貨も同じものですか？
いいえ——精算通貨は第 3 の独立した次元であり、Payin 契約ではなく精算設定で構成されます。 注文はある通貨で価格設定され、支払者には第 2 の通貨で請求され、お客様には第 3 の通貨で 精算されることがあります。 精算アカウントの構造 と 精算計算の解説 を参照してください。決済手段はアカウント全体で有効化されますか、それとも加盟店 ID ごとですか？
加盟店 ID ごとです。 契約は 1 つの加盟店 ID に属し、注文作成はリクエストに署名した 加盟店 ID の契約を検索します。したがって、ある加盟店 ID で決済手段を有効化しても、別の 加盟店 ID では有効化されません。複数の加盟店 ID を運用している場合——事業ラインごと、 地域ごとなど——依頼の際には、それが必要なすべての加盟店 ID を挙げてください。 実務上の帰結：- ある加盟店 ID では成功する同じリクエストが、別の加盟店 ID では
A0018を返すことがあります。 ペイロードを疑う前に、お客様の APIキーがどの加盟店 ID に属しているか確認してください。 - Service → Payin と inquiry 呼び出しは、常に一度に 1 つの加盟店 ID についてのみ回答します。
- 加盟店 ID を挙げたパラメーターエラーが返った場合、不一致はボディ内の ID とキーが属する ID の 間にあります—— 決済手段の設定と上限 を参照してください。
国ではなく地域単位で有効化してもらうことはできますか？
契約の行の次元は国であり、加えて、特定の 1 国に属さない決済手段のための独立した Global エントリがあります。その間に地域という単位はないため、「ヨーロッパ」や「日本と韓国」 は、必要な国の集合として表現され、それぞれが独自の行になります。 これはロールアウトを計画する際に知っておく価値があります：地域名ではなく国の一覧を依頼し、 結果として得られる Service → Payin ページは、地域ごとに 1 行ではなく、国と通貨の組み合わせごとに 1 行になると想定してください。決済手段を追加すると、すでに稼働中のものに影響しますか？
いいえ、ダウンタイムも発生しません。契約は独立した行です：追加すると新しい行が作成され、 既存の行のステータス、上限、返金ルールはそのまま維持されます。新しい決済手段の設定中も、 すでに運用中の決済手段のライブトラフィックには影響しません。 お客様側でも、何も変更する必要はありません——新しい決済手段を明示的に指定したい場合を 除いて。契約済みのものをチェックアウト画面にそのまま表示させている場合、新たにActive
になった行が単に表示され始めます。payMethodName / payMethodType をご自身で渡している
場合は、新しい値をいつから送り始めるかをお客様が決めます。新しく契約した決済手段が
チェックアウト画面のどこに表示されるかは
チェックアウト画面の表示ルール に、依頼がどのように
進むかは 決済手段の申し込み にあります。
サンドボックスで見た上限と通貨は、本番環境でも同じですか？
いいえ——サンドボックスで読み取った内容を本番環境の値や見積もりとして扱ってはいけません。 本番環境の値は、本番環境の Portal から、または本番環境の認証情報で/api/v1/paymethodconfig/inquiry を呼び出して読み取り、注文を作成する前にそれらに対して
検証してください。サンドボックスの数値がなぜ存在するのか、それが何の証拠であり何の証拠では
ないのかは、サンドボックス環境とアクセス
にあります。
手数料は商業条件であり、お客様自身の Payin ページにのみ表示されます——どこにも公開されて
いません。