支払いの詳細
このコンポーネントは payments
のサブセットであり、所定の決済の詳細なオーバーレイを提供します。支払いの詳細コンポーネントによって表示される UI は、ユーザーが決済の行をクリックするときに表示される payments
コンポーネントのオーバーレイに相当します。
payment-details
コンポーネントを使用して、支払い詳細のオーバーレイを呼び出します。この際にウェブサイトに payments
リスト全体をインライン化する必要はありません。これにより、既存の UI (支払いリストなど) から支払い詳細のオーバーレイを呼び出して Stripe の詳細ビューと統合できるため、顧客による支払いの詳細の表示、返金の発行、不審請求が申請された支払いの管理が可能になります。
By default, the embedded components offer limited information for destination charges and separate charges and transfers. They don’t provide access to customer information, payment methods, and some charge amount details. The destination_on_behalf_of_charge_management feature allows a connected account to see additional information with destination charges, as well as perform refunds and manage disputes.
アカウントセッションの作成時に、components
パラメーターで payment_details
を指定して、支払いの詳細を有効にします。payment_details
で features
パラメーターを指定することにより、支払いの詳細のコンポーネントの個々の機能を有効または無効にすることができます。
アカウントセッションを作成して、ConnectJS を初期化すると、フロントエンドに支払いの詳細のコンポーネントを表示できます。
注
デスティネーション支払いと支払いと送金別方式の場合、連結アカウントは、支払いに関連付けられた Payment Intent オブジェクトを所有していません。これらの支払いに対して、連結アカウントに属する支払いオブジェクトの ID を渡します。
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
機能を有効にすることには、次の制限があります。
- 支払いのステータスや決済手段で絞り込むことはできません。
- 特定のデータ列のエクスポートはできません。
デスティネーション支払いの不審請求の申請の管理
不審請求の申請がデスティネーション支払いまたは支払いと送金別方式で発生した場合、不審請求が申請された金額と不審請求の申請手数料がプラットフォームから引き落とされます。Connect の埋め込みコンポーネントは、アカウントセッション機能に関係なく、連結アカウントへの送金を差戻すことはありません。 不審請求の申請イベントをリッスンする Webhook を設定することをお勧めします。不審請求の申請が作成された場合、連結アカウントへの送金に対して口座引き落とし または送金の差戻しを作成できます。また、ダッシュボードを使用して連結アカウントへの送金を差戻すこともできます。不審請求の申請が終結した後は、不審請求の申請の結果に応じて連結アカウントの残高を更新できます。不審請求の申請で連結アカウントの主張が認められた場合は、送金を作成して、口座引き落としまたは送金の差戻しの影響を元に戻すことができます。
dispute_management
と destination_on_behalf_of_charge_management
の両方が有効になると、連結アカウントは、on_behalf_of
属性が設定されたデスティネーション支払いに対する不審請求の申請の反証資料の更新と変更、不審請求の申請への反論、および不審請求の申請の受け付けを行うことができます。
サポートされているパラメーター
この埋め込みコンポーネントは、次のパラメーターに対応します。