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

# どの決済手段と市場を受け付けられますか？

> 公開されている決済手段カタログから、カバレッジに関する質問を自分で解決する方法：どの市場が掲載されているか、テーブルがどのように行を集約しているか、同じ決済手段が 2 つの名前で現れる理由、ある決済手段がサブスクリプションや返金に対応しているかの見分け方、そして自社の契約済み一覧とカタログの違い。

「Y 国で X に対応していますか？」という質問のほとんどは、誰かに尋ねなくても答えが出ます。カタログが公開されているからです。
**[決済手段](/docs/ja/essentials/payment-methods)** には、Waffo のカタログに含まれるすべての決済手段について、
タイプ、対応市場、決済通貨、サブスクリプション対応、返金ルールを備えた絞り込み可能なテーブルがあります。

このページは**そのテーブルの読み方**についてです。1 行が何を意味するのか、フィルターが何をするのか、そしてテーブルでは
答えられない質問は何かを扱います。隣接する 3 つのページが近い領域をカバーしているため、ここでは繰り返しません。

* [自社の決済手段設定を読む](/docs/ja/support/payment-method-config-and-limits-faq) —
  **自社アカウント**についての同じ情報を、API から取得します。
* [Payin 契約と取引上限](/docs/ja/support/payin-agreements-and-limits-faq) —
  自社アカウントについての同じ情報を、Portal の表示で確認します。
* [決済手段の有効化](/docs/ja/support/payment-enrollment-faq) — 決済手段を自社アカウントに追加する方法。

## 対応している決済手段と市場の一覧はどこにありますか？

[決済手段](/docs/ja/essentials/payment-methods) にあります。テーブルには 3 つのフィルター — **Type**、**Country/Region**、
**Subscription** — と、次の列があります。

| 列 | 内容 |
| - | - |
| Type | `payMethodType` のカテゴリー — [完全な一覧は下記](#what-are-the-paymethodtype-categories) |
| Payment method | 決済手段のカタログ名。`payMethodName` として送信するのと同じつづり |
| Country/Region | その決済手段がカタログに登録されているすべての市場。ISO 3166-1 alpha-3 コード |
| Payment currency | その決済手段がカタログに登録されているすべての通貨 |
| Subscription | その決済手段がサブスクリプションプロダクトの下に存在するかどうか |
| Refundable | その決済手段でそもそも返金が可能かどうか |
| Partial refund | その決済手段が許可する返金の形式 |
| Refund period | 決済後どのくらいの期間、返金が可能か |

**Country/Region フィルターが「どの市場をカバーしていますか？」への正本です** — このページを含め、文章で書かれたどの一覧でもなく、
そこの現在の選択肢を読んでください。

2 つの市場コードは国ではありません。

| コード | 意味 |
| - | - |
| `EU_LIST` | 1 つのカタログエントリーとして扱われる欧州市場のグループ |
| `GLB` | グローバル — 市場に紐づかない。ステーブルコインの受け入れはこの形で登録されるため、購入者の国で絞り込まれることはありません |

## インド、モロッコ、パキスタン、ロシアはカバーされていますか？

この 4 つの市場はいずれも公開カタログに掲載されていません。Country/Region フィルターにない他の市場も同様です。
その絞り込みに市場がなければ、その市場向けにカタログ登録されたものはなく、誰が尋ねても答えは変わりません。

同じ判定で逆の質問も解決します。市場がフィルターにあれば、それは**カバーされています**。*お客様の*アカウントが
その市場で何かを契約しているかどうかは別の質問であり、カタログではなく
[自社の設定](/docs/ja/support/payment-method-config-and-limits-faq) が答えます。

## 1 行が複数の国と通貨をカバーしているのはなぜですか？

テーブルが表示前に集約しているためです。基になるカタログの行は市場、通貨、プロダクトごとに存在し、テーブルはそれらを
**決済手段名 + タイプ**でグループ化し、グループを 1 行にマージします。

| 列 | グループのマージ方法 |
| - | - |
| Country/Region | グループ内のすべての市場を重複排除してソート |
| Payment currency | グループ内のすべての通貨を重複排除してソート |
| Subscription | グループ内の**いずれか**の行がサブスクリプションプロダクトの下にあれば *Yes* |
| Refundable | グループ内の**いずれか**の行が返金可能なら *Yes* |
| Partial refund | グループ内で**最も許容的な**形式 |
| Refund period | グループ内で**最も長い**期間 |

その結果は重要です。3 か国と *Refundable: Yes* を示す行は、3 か国すべてで返金できることを約束するものでは**ありません**。
楽観的なマージにより、テーブルが答えるのは\*「これが当てはまることがあるか？」*であって、*「自分の市場で当てはまるか？」\*
ではありません。市場ごと・通貨ごとの答えが必要な場合は、各契約が個別のエントリーとなっている自社アカウントの設定
エンドポイントを使用してください。

## 同じ決済手段に見える名前が 2 つあるのはなぜですか？

ウォレットの市場別バリアントは、別々の名前と別々の契約を持つ別々のカタログエントリーだからです。たとえば
`ALIPAY` と `ALIPAYHK`、`WECHATPAY` と `WECHATPAYHK` です。市場、決済通貨、そしてお客様のアカウントがどのエントリーを
契約しているかが異なります。

実務上のルール：

* **`payMethodName` は、そのまま送信する値です。** 購入者が認識する名前ではなく、カタログまたは自社の設定レスポンスから
  取得してください。決済手段のチェックアウト表示名と `payMethodName` は、常に同じ文字列とは限りません。
* **一方のバリアントを契約していても、もう一方を契約したことにはなりません。** 契約していないバリアントを送信すると、
  注文作成は `A0018` で失敗します。[よくあるエラーのトラブルシューティング](/docs/ja/support/errors-troubleshooting-guide) を
  参照してください。
* 同じ名前でも市場が異なれば同様です。複数の市場でカタログ登録されている 1 つの決済手段名でも、契約は市場ごとに 1 つです。

## `payMethodType` のカテゴリーには何がありますか？

`payMethodType` は粗いカテゴリーで、固定の列挙型です。正確な `payMethodName` の代わりに注文作成時に送信すると、
購入者がカテゴリー内で選べるようになります。カンマ区切りで複数送信することもできます。

| 値 | カテゴリー |
| - | - |
| `EWALLET` | eウォレット |
| `CREDITCARD` | クレジットカード |
| `DEBITCARD` | デビットカード |
| `APPLEPAY` | Apple Pay |
| `GOOGLEPAY` | Google Pay |
| `ONLINE_BANKING` | オンラインバンキング |
| `DIGITAL_BANKING` | デジタルバンキング |
| `VA` | バーチャル口座 |
| `OTC` | 店頭払い |
| `OTCBANK` | 銀行窓口払い |
| `BNPL` | 後払い（Buy now, pay later） |
| `QR` | QR コード決済 |
| `QRIS` | QRIS |
| `USSD` | USSD |
| `NAPASCARD` | NAPAS カード |
| `KOREANCARDS` | 韓国国内カード |
| `PREPAIDCARD` | プリペイドカード |
| `UNIONPAY` | UnionPay |
| `CRYPTO` | ステーブルコイン — [ステーブルコイン決済](/docs/ja/support/stablecoin-payments-faq) を参照 |

つづりに注意してください。カードのカテゴリーは 1 語の `CREDITCARD` と `DEBITCARD` で、韓国国内カードは `KOREANCARDS` です。
`CARD`、`BANK_ACCOUNT`、`WALLET` という値は存在しません。

このうち 4 つのカテゴリー — `VA`、`OTC`、`CREDITCARD`、`DEBITCARD` — では、具体的な決済手段名を併せて指定する必要が
ありません。購入者がチェックアウトで具体的な選択肢を選ぶためです。それ以外のカテゴリーでは、購入者を意図的に Waffo の
チェックアウトへ送って選ばせる場合を除き、注文作成時に `payMethodName` が必要です。

## Apple Pay と Google Pay は個別に有効化が必要ですか？

はい。これらは独自のカタログカテゴリー（`APPLEPAY` と `GOOGLEPAY`）であり、市場ごとに独自のカタログエントリーを持つため、
それぞれが独自の契約です。カードが稼働していても、これらが稼働することにはなりません。どちらも契約以外に連携作業が
必要であり、そのため独自の公開ガイドがあります：
[Apple Pay](/docs/ja/developer-docs/integration/apple-pay/overview) と
[Google Pay](/docs/en/developer-docs/integration/google-pay/google-pay)。

同じ論理が他のどの決済手段にも当てはまります。カタログエントリーごとに契約が 1 つで、有効化は
[決済手段の有効化](/docs/ja/support/payment-enrollment-faq) の手順で行います。

## ある決済手段が継続課金に対応しているかは、どう判断しますか？

単一の契約に「サブスクリプション対応」のフラグはありません。サブスクリプション対応は**別のプロダクト**として表現されます。
カタログ行の `productName` です。Payin のプロダクトは 4 つあります。

| `productName` | 内容 |
| - | - |
| `ONE_TIME_PAYMENT` | 単発の決済 |
| `DIRECT_PAYMENT` | 購入者を Waffo のチェックアウトへ送らずに行う決済 |
| `SUBSCRIPTION` | 継続課金 |
| `MINI_PROGRAM_PAYMENT` | ウォレットのミニプログラム内での決済 — [ミニプログラム決済](/docs/ja/support/mini-program-payments-faq) を参照 |

したがって、ある決済手段が継続課金で利用できるのは、`SUBSCRIPTION` の下にその決済手段のカタログエントリーがある場合です。
公開テーブルではこれが **Subscription** 列であり、自社アカウントでは `productName` が `SUBSCRIPTION` である
`payMethodDetails` のエントリーです。

加盟店が頻繁に遭遇する 2 つの結果：

* **ワンタイムとサブスクリプションは別々に有効化されます。** ある決済手段がワンタイム決済で稼働していても、自社アカウントで
  継続課金に使えるようにはなりません。それは 2 つ目の契約です。
* 上記の集約ルールを思い出してください。公開テーブルの *Subscription: Yes* は、その決済手段の市場/通貨の組み合わせの
  少なくとも 1 つがサブスクリプションプロダクトの下にあるという意味であり、すべてではありません。

どの決済手段が再試行でうまく機能するか、ウォレットベースのサブスクリプションに何ができて何ができないかは
[サブスクリプションの決済手段と再試行](/docs/ja/support/subscription-retry-and-payment-methods-faq) と、公開されている
[サブスクリプション対応決済手段](/docs/ja/developer-docs/tools-and-references/references/subscription-payment-methods)
のページにあります。

## 決済手段は、購入者が Web にいるかアプリ内にいるかで変わりますか？

変わることがあります。コンテキストは `userInfo.userTerminal` で宣言します。

| 値 | 購入者の状況 |
| - | - |
| `WEB` | デスクトップブラウザー |
| `APP` | スマートフォン |
| `IN_WALLET_APP` | 決済手段自身のウォレットアプリ内 |
| `IN_MINI_PROGRAM` | 決済手段のミニプログラム内 |

何も送信しない場合のデフォルトは `WEB` です。すべての決済手段がすべての端末をサポートしているわけではないため、この値は
注文で使用できる決済手段を変えることがあります。ウォレット内の 2 つの値については、任意のコンテキストではなく、
そもそも決済を成立させるための必須要素です。

カタログには決済手段ごとの端末マトリクスはありません。確実に知る方法は注文作成のレスポンスです。購入者が実際にいる端末を
送信し、その決済手段が使用できるかどうかをレスポンスに語らせてください。ある文脈で決済手段が現れず別の文脈で現れたことから、
端末の制限を推測しないでください。

## `payOption` とは何ですか？ 各オプションを個別に有効化する必要がありますか？

`payOption` は決済手段の*内部*の副選択です。ウォレット残高からの支払い、デビットカードからの支払い、クレジットカードからの
支払いなどです。知っておくべきことが 2 つあります。

* **注文作成と照会では読み取り専用です。** 購入者が実際に選んだものを報告し、選択肢のない決済手段では空で返されます。
* **契約上はオプションごとに料金設定されることがあります。** その場合、
  [Payin 契約ページ](/docs/ja/support/payin-agreements-and-limits-faq) には決済手段ごとではなくオプションごとに手数料の行が
  表示され、オプション間に意味のある区別がない決済手段は `-` と表示されます。

したがって、オプションを決済手段のように 1 つずつ有効化することはありません。オプションは決済手段の契約に付いてきます。
見えるのは、購入者がどのオプションを選ぶかによって同じ決済手段の料金が異なることがある、という点です。

## カタログと自社の契約済み一覧はどう違いますか？

両者は異なる質問に答えており、これを混同することが「ドキュメントでは動くのに自分のアカウントでは動かない」の最もよくある原因です。

| 質問 | 答えの場所 |
| - | - |
| Waffo はそもそもこの決済手段を扱っているか？ | 公開カタログ |
| 自分はそれを契約しているか？ | `/api/v1/paymethodconfig/inquiry`、または Portal の **Service → Payin** |
| 今すぐ決済を受け付けられるか？ | 同じレスポンスの `currentStatus`、最終的には注文作成のレスポンス |
| 自分の金額上限はいくらか？ | 同じレスポンスの契約ごとの `orderAmountMin` / `orderAmountMax` |

自社の一覧は常により狭いものであり、連携で分岐すべきなのはそちらだけです。公開カタログは「どの市場で有効化を依頼すべきか」を
検討するための計画資料として扱い、実行時の正本としては決して扱わないでください。

## 次にどこを見ればよいですか？

* [自社の決済手段設定を読む](/docs/ja/support/payment-method-config-and-limits-faq) —
  自社の設定レスポンスの全フィールドと、そこから生じるエラー
* [決済手段の有効化](/docs/ja/support/payment-enrollment-faq) — 決済手段が追加される仕組みと、各有効化ステータスの意味
* [決済手段の返金と上限](/docs/ja/support/payment-method-refund-limits-faq) —
  決済手段ごとの返金形式、返金期間、返金の最小金額
* [チェックアウトの表示ルール](/docs/ja/support/cashier-display-rules-faq) —
  契約済みの決済手段がチェックアウトでどのように並べられ、グループ化されるか
* [決済手段](/docs/ja/essentials/payment-methods) — カタログそのもの


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