# 支払いの詳細

特定の支払いの詳細を表示し、ユーザーが不審請求の申請を管理したり、返金を実行できるようにします。

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

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

デフォルトでは、埋め込みコンポーネントはデスティネーション支払いと支払いと送金別方式の限られた情報しか提供しません。顧客情報、決済手段、一部の支払い金額の詳細にはアクセスできません。[destination_on_behalf_of_charge_management](https://docs.stripe.com/connect/supported-embedded-components/payment-details.md#allow-your-connected-accounts-to-manage-destination-charges) 機能を使用すると、連結アカウントは返金の実行、不審請求の申し立ての管理、顧客情報、決済手段、手数料などのデスティネーション支払いの追加情報の確認を行うことができます。

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

[アカウントセッションの作成](https://docs.stripe.com/api/account_sessions/create.md)時に、`components` パラメーターで `payment_details` を指定して、支払いの詳細を有効にします。`payment_details` で `features` パラメーターを指定することにより、支払いの詳細のコンポーネントの個々の機能を有効または無効にすることができます。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_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 を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)すると、フロントエンドに支払いの詳細のコンポーネントを表示できます。

#### JavaScript

```js
// 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);
```

> [デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)と[支払いと送金別方式](https://docs.stripe.com/connect/separate-charges-and-transfers.md)の場合、連結アカウントに PaymentIntent が存在しません。代わりに、連結アカウントに属する関連付けられた支払い ID を渡します。

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

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

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

`destination_on_behalf_of_charge_management` 機能を `true` に設定すると、連結アカウントは支払いコンポーネントで [on_behalf_of](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-on_behalf_of) 属性が設定されている[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)を表示および管理できます。`dispute_management` 機能も有効にすると、連結アカウントは[不審請求の申請の処理に直接参加する](https://docs.stripe.com/connect/supported-embedded-components/payments.md#dispute-management-for-destination-charges)こともできます。

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

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

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

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

[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)では、`on_behalf_of` の有無にかかわらず、Stripe はプラットフォームアカウントから不審請求の申し立てに係る金額と手数料を引き落とします。

[不審請求の申し立て作成イベント](https://docs.stripe.com/api/events/types.md#event_types-charge.dispute.created)をリッスンするために、[Webhook](https://docs.stripe.com/webhooks.md) を設定することをお勧めします。このような状況が発生した場合は、[ダッシュボード](https://dashboard.stripe.com/test/transfers)から送金を差戻すか、[送金の差戻しを作成](https://docs.stripe.com/api/transfer_reversals/create.md)して、連結アカウントから売上の回収を試みることができます。

連結アカウントの残高がマイナスの場合、`debit_negative_balances` が `true` に設定されていれば、Stripe は[その外部口座からの引き落とし](https://docs.stripe.com/connect/account-balances.md#automatically-debit-connected-accounts)を試みます。

不審請求の申し立てに反論して主張が認められた場合は、以前に差戻した売上を連結アカウントに送金できます。プラットフォームの残高が不足している場合、送金は失敗します。[Stripe 残高に資金を追加](https://docs.stripe.com/get-started/account/add-funds.md)して、残高不足によるエラーを防止してください。

> 以前差戻した売上を再送金する場合、[海外送金に関する制限](https://docs.stripe.com/connect/account-capabilities.md#transfers-cross-border)の対象となるため、連結アカウントに返済する方法がなくなる可能性があります。その場合は代わりに、不審請求の申し立てがなくなるまで、`on_behalf_of` を指定したデスティネーション支払いで、不審請求の申し立てが行われた海外への支払い送金が回復されるのを待ちます。

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

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

#### HTML + JS

| メソッド         | タイプ          | 説明                                                                                                                                                                                                                                                 |    |
| ------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `setPayment` | `string`     | オーバーレイに表示する決済、支払い、または PaymentIntent の ID。これは連結アカウントでの決済、支払い、または PaymentIntent の ID にする必要があります。この属性が定義されていない場合、埋め込みコンポーネントには何も表示されません。この ID を取得するには、[Charge (支払い) API](https://docs.stripe.com/api/charges.md) をクエリするか、実装で作成または保存されている決済 ID を使用します。 | 必須 |
| `setOnClose` | `() => void` | ユーザーがオーバーレイを閉じたときにこのイベントを送信します。                                                                                                                                                                                                                    |    |

このコンポーネントの閉じる動作を有効にするには、`setOnClose` を呼び出して `close` イベントをリッスンします。

#### React

| React のプロパティー | タイプ          | 説明                                                                                                                                                                                                                                                    |    |
| ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `payment`     | `string`     | オーバーレイに表示する決済、支払い、または PaymentIntent の ID。これは連結アカウントでの決済、支払い、または PaymentIntent の ID にする必要があります。このパラメーターが渡されていない場合、埋め込みコンポーネントには何も表示されません。この ID を取得するには、[Charge (支払い) API](https://docs.stripe.com/api/charges.md) をクエリするか、実装で作成または保存されている決済 ID を使用します。 | 必須 |
| `onClose`     | `() => void` | ユーザーがオーバーレイを閉じたときに実行される関数。                                                                                                                                                                                                                            | 必須 |