# Smart Disputes 手数料のパススルー

Smart Dispute 手数料を連結アカウントにパススルーする方法またはマークアップする方法をご紹介します。

プラットフォームは、[Smart Disputes](https://docs.stripe.com/disputes/smart-disputes.md) を有効化して連結アカウントに代わって不審請求の申し立てに異議を申し立てることができます。貴社プラットフォームが不審請求の申立手数料を支払う場合、Smart Disputes 手数料パススルー機能を使用して、Disputes の手数料を連結アカウントにパススルー、またはマークアップすることができます。これにより不審請求にかかるコストを自社で吸収することなく、自動化された不審請求管理を提供し、Smart Disputes を収益化することができます。

## 利用資格

Smart Disputes 手数料パススルー機能を使用するには、貴社プラットフォームが以下のすべてに該当する必要があります。

1. 連結アカウントに対して Smart Disputes が有効になっていること。
1. 連結アカウントではなく貴社プラットフォームが Smart Disputes の手数料を支払っていること。
1. 連結アカウントが、支払いと送金別方式ではなく、ダイレクト支払いまたはデスティネーション支払いを使用していること。
1. プラットフォームと連結アカウントは[アカウント引き落とし](https://docs.stripe.com/connect/account-debits.md)が可能な地域にあります。

> #### ダイレクト支払いの手数料負担者の設定
> 
> [一部のプラットフォーム設定](https://docs.stripe.com/connect/direct-charges-fee-payer-behavior.md)では、連結アカウントが不審請求の申立手数料を支払います。ダイレクト支払いの場合、手数料負担者の属性が `application_unified_accounts_beta` に設定されている場合にこれが発生します。この動作を変更して Smart Disputes 手数料のパススルー機能を利用して連結アカウントの Smart Disputes 利用料を管理するには、[営業](https://stripe.com/contact/sales)にお問い合わせください。

## 料金体系の設定

ノーコードの[プラットフォーム料金体系ツール](https://docs.stripe.com/connect/platform-pricing-tools.md)の Smart Disputes タブで、対象となるすべての連結アカウントのデフォルトの料金体系を設定します。

料金は、不審請求の申し立てを受けた取引金額に対する割合 (最大 50%) で設定できます。エディターで以下のいずれかのオプションを選択してください。

- 対象となる取引額に対する割合を設定する。
- 手数料をパススルーする。
- 手数料をパススルーしない。

ダッシュボードの[連結アカウントページ](https://dashboard.stripe.com/connect/accounts)の収益化セクションで、個々の連結アカウントの料金体系をカスタマイズすることもできます。

料金体系を設定したら、Smart Disputes が有効になっていることと、プラットフォームの料金体系ツールで設定した割合と料金が一致していることを連結アカウントに通知します。

## マイナス残高に対する責任

Smart Disputes 手数料パススルーを使用すると、連結アカウントの残高がマイナスの場合でも連結アカウントから引き落としができます。この動作は、プラットフォームの[マイナス残高に対する責任](https://docs.stripe.com/connect/risk-management.md#risk-options)がどのように設定されているかによって異なります。

- 連結アカウントの残高がマイナスで、Stripe がマイナス残高の責任を負う場合でも、プラットフォームは不審請求の申し立て手数料パススルーを通じて資金を徴収することができます。
- 連結アカウントの残高がマイナスで、プラットフォームがマイナス残高の責任を負う場合、Stripe は貴社プラットフォームのリザーブ残高から不審請求の申し立て手数料のパススルーを通じて資金を徴収します。

## テスト中

プラットフォームが価格を設定したら、テスト用の smart dispute を作成して `winning_evidence` とともに smart evidence を提出して、Smart Disputes とその手数料パススルー機能を試行してください。

#### ダイレクト支払い

Smart Disputes の対象となる支払いを作成します。

```curl
curl https://api.stripe.com/v1/charges \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=5000 \
  -d currency=usd \
  -d source=tok_createAutoRepresentmentEligibleDispute
```

次に、発生した支払いに対する不審請求申し立てを取得します。

```curl
curl -G https://api.stripe.com/v1/disputes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "charge={{CHARGE_ID}}"
```

不審請求の申し立てを主張が認められたとして解決するには、Smart Disputes 経由で `winning_evidence` とともに不審請求申し立て ID を提出してください。

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d intended_submission_method=smart_disputes \
  -d "evidence[uncategorized_text]=winning_evidence"
```

不審請求の申し立ては主張が認められたというステータスに変更されます。更新されたステータスを確認するには、不審請求の申し立てを再度取得する必要がある場合があります。

Stripe は 24 時間以内に Smart Disputes 手数料をプラットフォームに請求します。Stripe はさらに 6 時間以内に連結アカウントに手数料をパススルーします。

#### デスティネーション支払い

Smart Disputes の対象となる支払いを作成します。

```curl
curl https://api.stripe.com/v1/charges \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=5000 \
  -d currency=usd \
  -d source=tok_createAutoRepresentmentEligibleDispute \
  -d "transfer_data[destination]={{ACCOUNT_ID}}"
```

次に、発生した支払いに対する不審請求申し立てを取得します。

```curl
curl -G https://api.stripe.com/v1/disputes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -d "charge={{CHARGE_ID}}"
```

不審請求の申し立てを主張が認められたとして解決するには、Smart Disputes 経由で `winning_evidence` とともに不審請求申し立て ID を提出してください。

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -d intended_submission_method=smart_disputes \
  -d "evidence[uncategorized_text]=winning_evidence"
```

不審請求の申し立ては主張が認められたというステータスに変更されます。更新されたステータスを確認するには、不審請求の申し立てを再度取得する必要がある場合があります。

Stripe は 24 時間以内に Smart Disputes 手数料をプラットフォームに請求します。Stripe はさらに 6 時間以内に連結アカウントに手数料をパススルーします。