不審請求の申し立てリスト

不審請求の申し立てリストコンポーネントは、連結アカウントに関連する不審請求の申し立てを表示します。リストの各行は、不審請求の申し立てを表します。連結アカウントが行をクリックすると、不審請求の申し立てとそれに対応する支払いの詳細情報が表示されます。dispute_management 機能を有効にすると、連結アカウントは反証資料の提出や不審請求の申し立ての承諾など、不審請求の申し立てを管理するためのアクションを実行できます。さらにこのコンポーネントには、特定の基準に基づいて不審請求の申し立てをフィルタリングする機能や、不審請求の申し立てリストをエクスポートして詳細な分析や記録を管理する機能も含まれています。

アカウントセッションを作成するときに、components パラメーターに disputes_list を指定して、このコンポーネントを有効にします。disputes_list で features パラメーターを指定することで、支払いの詳細コンポーネントの個々の機能を有効または無効にできます。

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[disputes_list][enabled]"=true \
  -d "components[disputes_list][features][refund_management]"=true \
  -d "components[disputes_list][features][dispute_management]"=true \
  -d "components[disputes_list][features][capture_payments]"=true \
  -d "components[disputes_list][features][destination_on_behalf_of_charge_management]"=false

アカウントセッションを作成し、ConnectJS を初期化したら、不審請求の申し立てリストコンポーネントをフロントエンドに表示できます。

// Include this element in your HTML
const disputesList = stripeConnectInstance.create('disputes-list');
container.appendChild(paymentDisputes);

デスティネーション支払いの不審請求の申し立ての管理

デフォルトでは、埋め込みコンポーネントは、ダイレクト支払いを受け付ける Connect の実装との互換性が最もあります。on_behalf_of 属性を持つデスティネーション支払いに関連する不審請求の申し立てをユーザーが確認できるようにするには、destination_on_behalf_of_charge_management 機能を有効にします。それ以外の場合、このコンポーネントにはこれらのタイプの支払いの不審請求の申し立ては含まれません。

dispute_management と destination_on_behalf_of_charge_management を両方とも有効にすると、連結アカウントは、on_behalf_of 属性が自身に設定されたデスティネーション支払いに対する不審請求の申し立てについて、反証資料の更新と変更、反論、および承諾を行うことができます。

デスティネーション支払いでは、on_behalf_of の有無にかかわらず、Stripe はプラットフォームアカウントから不審請求の申し立てに係る金額と手数料を引き落とします。

不審請求の申し立て作成イベントをリッスンするために、Webhook を設定することをお勧めします。このような状況が発生した場合は、ダッシュボードから送金を差戻すか、送金の差戻しを作成して、連結アカウントから売上の回収を試みることができます。

連結アカウントの残高がマイナスの場合、debit_negative_balances が true に設定されていれば、Stripe はその外部口座からの引き落としを試みます。

不審請求の申し立てに反論して主張が認められた場合は、以前に差戻した売上を連結アカウントに送金できます。プラットフォームの残高が不足している場合、送金は失敗します。Stripe 残高に資金を追加して、残高不足によるエラーを防止してください。