支払いの詳細

このコンポーネントは payments のサブセットであり、所定の決済の詳細なオーバーレイを提供します。支払いの詳細コンポーネントによって表示される UI は、ユーザーが決済の行をクリックするときに表示される payments コンポーネントのオーバーレイに相当します。

payment-details コンポーネントを使用して、支払い詳細のオーバーレイを呼び出します。この際にウェブサイトに payments リスト全体をインライン化する必要はありません。これにより、既存の UI (支払いリストなど) から支払い詳細のオーバーレイを呼び出して Stripe の詳細ビューと統合できるため、顧客による支払いの詳細の表示、返金の発行、不審請求が申請された支払いの管理が可能になります。

デフォルトでは、埋め込みコンポーネントでの、デスティネーション支払いと支払いと送金別方式についての情報の表示は限定的です。顧客情報、支払い方法、支払い金額の詳細へはアクセスできません。 destination_on_behalf_of_charge_management機能により、連結アカウントはデスティネーション支払いによる追加情報を確認でき、返金の実行や不審請求の申請の管理を行います。

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

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

アカウントセッションを作成して、ConnectJS を初期化すると、フロントエンドに支払いの詳細のコンポーネントを表示できます。

// Include this element in your HTML
const paymentDetails = stripeConnectInstance.create('payment-details');
paymentDetails.setPayment('{{PAYMENT_INTENT_OR_CHARGE_ID}}');
// use setOnClose to set a callback function to close payment-details
paymentDetails.setOnClose(() => {
  paymentDetails.remove();
});
container.appendChild(paymentDetails);

payment details コンポーネントは、支払いタイプごとに異なる情報を示し、異なる機能をサポートします。

• ダイレクト支払いの場合、連結アカウントはすべての情報を表示できます。アカウントセッションの作成時に対応する機能を有効にした場合は、返金の管理、不審請求の申請の管理、支払いのキャプチャーも行うことができます。
• デスティネーション支払いと支払いと送金別方式の場合、連結アカウントはこの選択された支払いに関連付けられた送金オブジェクトのみを表示でき、これに含まれる情報は限定的です。
• on_behalf_of 属性が指定されたデスティネーション支払いの場合、連結アカウントは destination_on_behalf_of_charge_management 機能が有効な場合にすべての情報を表示できます。この機能が有効になっている場合、対応する機能を有効にすることで、返金および不審請求の申請の管理を有効にすることもできます。

連結アカウントによるデスティネーション支払いの管理を許可する

destination_on_behalf_of_charge_management 機能を true に設定すると、連結アカウントは支払いコンポーネントで on_behalf_of 属性が設定されているデスティネーション支払いを表示および管理できます。dispute_management 機能も有効にすると、連結アカウントは不審請求の申請の処理に直接参加することもできます。

destination_on_behalf_of_charge_management 機能を有効にすることには、次の制限があります。

1. 支払いのステータスや支払い方法で絞り込むことはできません。
2. 特定のデータ列のエクスポートはできません。

デスティネーション支払いに対する不審請求の申請を管理する

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

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

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

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

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

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

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