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

# 決済手段別の返金制限

> 同じ返金リクエストがある決済手段では成功し別の決済手段では拒否される理由：一部返金の利用可否、返金期間と期限、1 注文で許可される返金回数、重複リクエスト保護、キャプチャ前後の返金、閉鎖されたユーザーアカウント、イシュアに拒否されたカード返金。

[返金 FAQ](/docs/ja/support/refund-faq) では、すべての返金に適用されるルール（金額バリデーション、冪等なリトライ、
異なる通貨間の換算、非同期ステータス、手数料の返還）を扱っています。このページはその次に来る問いに答えます：
**同一のリクエストがある決済手段では成功し、別の決済手段では拒否されるのはなぜか。** 異なる通貨間の計算は
[為替レート](/docs/ja/support/exchange-rates-faq)に、関連するエラーコードは
[エラーコードと制限の補足](/docs/ja/support/error-codes-and-limits-supplement)にあります。

要約すると：**返金能力は貴社のアカウントではなく、決済手段の属性です。** 同じアカウントで有効化され、
同じ連携を通じて請求された 2 つの決済手段が、まったく異なる返金動作を持つことがあります。

## 同じ返金リクエストがある決済手段では成功し、別の決済手段では失敗するのはなぜですか？

各決済手段が独自の返金ルールを持ち、Waffo はそれを緩和しないからです。API のインターフェースはすべての決済手段で
同一で、異なるのはその決済手段がどのリクエストを受け付けるかです。

下の表は、私たちが観察する動作を**決済手段カテゴリ**別にまとめたものです。特定の決済手段の参照表ではなく、
設計上考慮すべきばらつきの形として扱ってください。貴社アカウントで有効な決済手段の正確なルールは、
貴社の決済手段設定の一部です。

| 決済手段カテゴリ | 全額返金 | 一部返金 | 複数回の一部返金 | 注目すべき制限 |
| - | - | - | - | - |
| カード | 可 | 設定による。カードの設定によっては全額返金のみ | 一部返金が利用可能な場合 | Waffo がリクエストを受理した後でも、**イシュア銀行に拒否される**ことがある |
| 電子ウォレット | 可 | 一般的に可 | 一般的に可。貴社アカウントで有効化された後のみの場合もある | 重複リクエスト保護と、リクエスト間の最小間隔 |
| プリペイド電子マネー | 可 | 可 | **不可** — 元取引ごとに 1 回の返金 | 元取引後の固定期間内のみ返金可能 |
| 後払い / クレジット（BNPL 型） | 可 | 可（ユーザーのアカウントが有効な間） | 決済手段による | 期間はその決済手段の与信保持期間に紐づく。**閉鎖されたユーザーアカウント**は一部返金をブロックする |
| 銀行振込 / バーチャル口座 | 決済手段による — いくつかは **API 経由でまったく返金できない** | 同左 | 同左 | API で返金できない場合、資金は決済手段の外で返還される（[銀行振込とバーチャル口座](/docs/ja/support/bank-transfer-and-virtual-account-faq)を参照） |
| オーソリとキャプチャが分離した決済手段 | 可 | **キャプチャ後のみ** | キャプチャ後 | キャプチャ済み決済の取消には、決済から起算する独自の期限がある |

設計上考慮する価値のある 3 つの結論：

1. 「この決済手段は一部返金をサポートする」と自社コードにハードコードしないでください。返金を送信し、拒否を処理してください。
2. アカウント上のある決済手段が何かをサポートしているからといって、別の決済手段もサポートしていると仮定しないでください。
3. Waffo が受理した返金でも、最終的に失敗状態で終わることがあります。

## 有効化したすべての決済手段で一部返金は利用できますか？

いいえ。一部返金は、特定の決済手段で利用可能であり、**かつ**貴社アカウントで有効化されている必要がある能力です。
Service → Payin 行の `Refundable` 列がそれです。行が全額返金のみを許可している場合、一部返金リクエストは `A0014`
（「Order cannot be refunded due to refund rules」）で拒否され、同じ注文の全額返金は成功します。行が 1 回の一部返金を
許可し、2 回目を要求した場合も同じコードが返されます。

`A0017`（「Order cannot be refunded due to payment channel not supported」）は別の失敗です。決済手段自体が返金を
まったく扱えないため、一部返金も全額返金もその決済手段では通りません。

決済手段が複数の動作をとりうる場合、**最も制限的な選択肢が適用されます**。実際には：

* ある決済手段が貴社アカウントでは全額返金しかできない場合、その決済手段が他所では一部返金に対応していても、
  一部返金リクエストは失敗します。
* ある決済手段が貴社アカウントでは 1 回の一部返金のみを許可する場合、1 回目が成功しても 2 回目のリクエストは失敗します。

Waffo が一部返金を黙って全額返金に格下げすることはなく、後回しのキューに入れることもありません。現在拒否されている
能力が必要な場合は、Waffo の連携担当者に有効化できるか確認してください。これは設定変更であり、パラメーターとして
渡せるものではありません。

## 1 つの注文で何回まで返金できますか？

3 つの独立した上限が適用され、最も低いものに到達した時点で止まります。

| 上限 | 値 | 超過時のエラー |
| - | - | - |
| Waffo プラットフォームの注文あたり上限 | **50** 回 | `A0027` 「The refund has exceeded maximum 50 times」 |
| 金額 | 返金済み + 処理中 + 今回のリクエスト ≤ 元の決済金額 | `A0003` — 返金ルール違反ではなく、パラメーターの失敗として扱われる |
| 契約上の返金形態 | 「1 回のみ返金」「注文あたり 1 回の一部返金」から無制限の一部返金まで | `A0014` |

一部の決済手段は注文あたりちょうど 1 回の一部返金から始まり、そこから引き上げることができます。回数にまったく
制限を設けない決済手段も少数あります。最も低い上限が優先されるため、拒否された 2 回目の返金がインシデントではなく
通常の分岐となるように照合を構築してください。

## 注文の返金に期限はありますか？

はい。起算点は常に**元の注文**であり、返金を決めた時点ではありません。期間は貴社アカウントの決済手段行の属性であり、
推測するのではなく 2 つの場所で確認できます。

| 場所 | 表示内容 |
| - | - |
| Service → Payin の `Refund Period` 列 | その決済手段と通貨の期間 |
| 注文の `refundExpiryAt`（Order Inquiry） | その注文の具体的な期限 — 期間から導出され、注文の作成日から起算し、その日の終わりに到達する |

形はカテゴリによって異なります。プリペイド電子マネーと後払いの決済手段は最も短い期間、カードはイシュアの条件の下で
最も長い期間になりがちですが、数値は決済手段ごと・アカウントごとなので、ある決済手段の期間を別の決済手段に
当てはめないでください。

期間が終了すると返金は拒否され、上書きはできません。貴社のプロダクトが長期間の返品を許可している場合は、
ポリシーを公開する前に受け付ける決済手段の返金期間を確認し、遅い返品は元の決済の外で処理してください。

## 注文を返金しましたが、`orderStatus` が変わりません。返金は成功したのですか？

はい、おそらく成功しています。**返金は元の注文のステータスを変更しません。** 元の注文は支払われたときに到達した
状態のままで、返金は独自のステータスを持つ別の記録であり、返金の進捗が表示されるのはそこだけです。

| 見る場所 | 表示内容 |
| - | - |
| 元の注文に対する `/api/v1/order/inquiry` | 元の決済ステータス。返金によって変わらない |
| 返金に対する `/api/v1/refund/inquiry` | `REFUND_IN_PROGRESS` → `ORDER_PARTIALLY_REFUNDED` / `ORDER_FULLY_REFUNDED` / `ORDER_REFUND_FAILED` |
| 返金注文の通知 | 最終的な返金状態 |

したがって、「注文がまだ支払済みと表示されている」ことは返金が失われた証拠ではありません。貴社の帳簿が元の注文を
キーに返金状態を管理していると、永久に止まっているように見えます。代わりに返金記録をキーにしてください。

## 返金を即座に再送したところ、重複として拒否されました。何か返金されましたか？

2 回目のリクエストではおそらく返金されていません。それがこの保護の目的です。2 種類のガードがあります。

* **重複検出。** 一部の決済手段は、同じ元取引参照*かつ*同じ金額を持つ 2 回目のリクエストを短時間内に拒否します。
  一部返金の回数に制限を設けないウォレットでよく見られるルールです。
* **最小間隔。** 一部の決済手段は、同じ注文に対する連続した返金リクエストの間に短い間隔を要求します。

いずれも誤った二重返金に対する保護なので、この拒否を、短いループでリトライすべき失敗として扱わないでください。安全なパターン：

1. *同じ*返金を再送するときは同じ `refundRequestId` を維持してください。これは冪等キーであり、リトライを無害にします。
2. 同じ注文に対する本物の 2 回目の返金を連続して発行しないでください。1 回目が最終状態に達するのを待ってください。
3. 試行の間は、再送するのではなく `/api/v1/refund/inquiry` を呼び出してください。

## ユーザーがアカウントを閉鎖または削除しました。まだ返金できますか？

常にできるわけではありません。後払い / クレジットの決済手段では、**閉鎖されたユーザーアカウントは一部返金をブロック**し、
閉鎖から定められた期間が経過すると返金は完全に拒否されます。全額返金は通常より長く可能です。

Waffo が閉鎖されたアカウントを迂回する方法はありません。資金は元のアカウントに戻る必要があります。この理由で返金が
拒否された場合は、他の手段でユーザーと精算してください。

## 決済がキャプチャされる前に返金できますか？

全額のみ可能です。オーソリとキャプチャが別ステップの決済手段では：

| 注文状態 | できること |
| - | - |
| オーソリ済み、未キャプチャ | **全額返金 / キャンセルのみ** — 一部返金は不可 |
| キャプチャ済み | 全額または一部返金。決済手段の一部返金ルールに従う |
| キャプチャ済み、取消中 | 取消には決済から起算する独自の期限がある。注文の `refundExpiryAt` を読み取る |

キャプチャ自体にも期限があり、キャプチャ金額が元のオーソリ金額を超えることはありません。オーソリの一部を返す
必要がある場合は、オーソリ全体をキャプチャして差額を返金するのではなく、保持する金額をキャプチャしてください。

## アカウント上のある決済手段は全額返金しかできず、別の決済手段は複数回の一部返金を受け付けるのはなぜですか？

返金能力はアカウントではなく**決済手段**に従うからです。1 つのアカウントに、全額返金のみのカード決済手段と、
繰り返しの一部返金を受け付けるウォレット決済手段が並ぶことは日常的です。貴社のアカウント、契約タイプ、
呼び出す API のいずれも、それを変えることはありません。

設計上の含意は具体的です。返金 UI とカスタマーサービスのスクリプトは、アカウント全体の単一ルールではなく、
注文で使用された決済手段によって駆動されるべきです。

## 最小返金金額と最大返金金額はありますか？

最大は常に同じで、**元の決済金額**から、すでに返金済みまたは処理中の金額を差し引いたものです。受け取った以上を
返せる決済手段はなく、それ以上を要求すると `A0003` で拒否されます。

最小は人々がつまずく実務的なものです。それはその通貨が表現できる最小の金額であり、異なる通貨間の注文では
*換算後*の数値が表現できる最小の金額です。そのため、貴社には非ゼロに見える返金が拒否されることがあります。
換算後の金額がゼロ以下になる場合、返金は `A0014` で拒否されます。
[制限、通貨、設定エラー](/docs/ja/support/error-codes-and-limits-supplement)を参照してください。

異なる通貨間の注文で有用な習慣：自社通貨での絶対額ではなく、元の注文に対する**割合**で返金してください。
そうすれば換算後の金額が丸めで消えるのではなく、元の決済に比例します。

## 返金は成功と報告されていますが、ユーザーは資金が届いていないと言っています

両方の発言が同時に真でありえます。返金の成功とは**返金リクエストが正常に完了した**ことを意味し、資金がすでにユーザーの
アカウントに着金したことを意味するものではありません。返金の精算はその成功結果に基づいて行われ、ユーザーの残高には
基づきません。

実際にはほとんどの決済手段で資金はすぐに続きますが、2 つのイベントは別であり、その間隔は Waffo の管理外です。

| 観察するもの | 意味 |
| - | - |
| `ORDER_FULLY_REFUNDED` / `ORDER_PARTIALLY_REFUNDED` | 返金が決済手段によって受理・処理された |
| ユーザーの残高 | 決済手段または銀行自身の記帳タイミング |

したがってサポートの回答は「返金は完了しています。反映の速さはユーザーの銀行またはウォレット次第です」となります。
返金が成功の最終状態になってから相当な時間が経過しても、ユーザーがまだ確認できない場合にのみ Waffo サポートに
エスカレーションしてください。その際は元の注文 ID と返金 ID を添えてください。

## 返金が `ORDER_REFUND_FAILED` で終わりました。何が起きたのですか？どうすればよいですか？

`ORDER_REFUND_FAILED` は**最終**状態です。資金は動いておらず、その返金記録で動くこともありません。カード決済で
最も一般的な原因は、Waffo がリクエストを受理した後に**イシュア銀行が返金を拒否した**ことで、そのため失敗は
API エラーではなく非同期で届きます。

対処方法：

1. 返金注文の通知または `/api/v1/refund/inquiry` で理由を確認してください。
2. 異なる結果を期待して同じ `refundRequestId` で再送しないでください。最終状態は再開されません。
3. 拒否が金額、期間、決済手段のルールで説明できない場合は、元の注文 ID と返金 ID を添えて Waffo サポートに
   提起してください。貴社の管理外の理由で失敗した返金は個別に対応されます。
4. カードにまったく入金できない場合は、別の経路でユーザーと精算してください。

## これらの制限のどれが私に適用されますか？どこで確認できますか？

送信前に読み取れる単一の「返金能力」フィールドはありません。頼りにできるもの：

* **Merchant Portal → PayIn** ページには、貴社アカウントで有効な決済手段が、その通貨と金額制限とともに一覧表示されます。
* `/api/v1/paymethodconfig/inquiry` は同じ設定をプログラムで返します。
* 特定のリクエストに対する返金 API の拒否が正式な答えです。`A0014` は契約の返金ルールが許可しないこと
  （形態、回数、期間、または換算後にゼロに丸まる金額）、`A0017` は決済手段が返金をまったく扱えないこと、
  `A0027` はプラットフォームの回数上限に達したこと、`A0003` は金額が残額を超えているか、必須の返金フィールドが
  欠けており、それがレスポンスに列挙されていることを意味します。

そのため、堅牢な連携パターンは**試行してから分岐する**ことであり、**予測してから試行する**ことではありません。

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

| 質問 | ページ |
| - | - |
| 一般的な返金ルール、バッチ返金、手数料の返還 | [返金 FAQ](/docs/ja/support/refund-faq) |
| 異なる通貨間の注文の返金金額 | [為替レート](/docs/ja/support/exchange-rates-faq) |
| 銀行振込の過払い・不足 | [銀行振込とバーチャル口座](/docs/ja/support/bank-transfer-and-virtual-account-faq) |
| ステーブルコインの返金と必須の返金アドレス | [ステーブルコインの例外と返金](/docs/ja/support/stablecoin-exceptions-faq) |
| 返金関連の各エラーコードの意味 | [エラーコードと制限の補足](/docs/ja/support/error-codes-and-limits-supplement) |


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