決済の不審請求の申し立て

連結アカウントの UI コンポーネントをレンダリングして特定の決済に適用される不審請求の申し立てを表示します。連結アカウントは、不審請求の申請の理由、ステータス、金額、作成日など、各不審請求の申し立ての詳細を確認できます。アカウントセッションの dispute_management 機能を有効にすると、連結アカウントは反証資料の提出や不審請求の申し立ての受理などのアクションを実行できます。この機能は、決済の詳細コンポーネントでも利用できます。

このインラインコンポーネントは、他の決済 UI と同じページに実装できます。フルスクリーン、オーバーレイ、ドロワー、または幅を調整できるその他のレイアウトでの使用に適しています。決済に関連する不審請求の申し立てがない場合、コンポーネントは何もレンダリングしません。また、不審請求の申し立てがない場合の、異なるマージンなどのカスタム処理を設定することもできます。これを行うには、onDisputesLoaded を使用してカスタムコールバック関数を設定します。

まれに、顧客が作成した同じ決済に対して、連結アカウントが複数の不審請求の申し立てを受けることがあります。連結アカウントは、同じ決済に対する不審請求の申し立てを個別に確認し、処理する必要があります。決済の成功率を高めるために、このベストプラクティスを連結アカウントに知らせることをお勧めします。

デフォルトでは、埋め込みコンポーネントは、ダイレクト支払いを受け付ける Connect の実装との互換性が最もあります。埋め込みコンポーネントでは、決済リストに表示されるデスティネーション支払いおよび個別の決済と送金に関する情報は限られており、この UI コンポーネントはこれらの支払いタイプに対して何もレンダリングしません。on_behalf_of 属性を持つデスティネーション支払いに関連する不審請求の申し立てをユーザーが確認できるようにするには、destination_on_behalf_of_charge_management 機能を有効にします。

When creating an Account Session, enable this component by specifying payment_disputes in the components parameter. You can turn on or off an individual feature of the payment details component by specifying the features parameter under payment_disputes:

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

After creating the account session and initializing ConnectJS, you can render the Disputes for a payment component in the frontend:

// Include this element in your HTML
const paymentDisputes = stripeConnectInstance.create('payment-disputes');
paymentDisputes.setPayment('{{PAYMENT_INTENT_OR_CHARGE_ID}}');
container.appendChild(paymentDisputes);

サポートされているパラメーター

この組み込みコンポーネントは、次のパラメーターに対応します。

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

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

For destination charges, with or without on_behalf_of, Stripe debits dispute amounts and fees from your platform account.

We recommend setting up a webhook to listen to dispute created events. When that happens, you can attempt to recover funds from the connected account by reversing the transfer through the Dashboard or by creating a transfer reversal.

If the connected account has a negative balance, Stripe attempts to debit its external account if debit_negative_balances is set to true.

If you challenge the dispute and win, you can transfer the funds that you previously reversed back to the connected account. If your platform has an insufficient balance, the transfer fails. Prevent insufficient balance errors by adding funds to your Stripe balance.