# 即時入金プロモーション

連結アカウントの即時入金コンバージョンを向上させるプロモーションコンテンツを表示します。

即時入金を実行する機能と、即座に入金可能な資金額を表示する連結アカウント向けの UI コンポーネントをレンダリングします。連結アカウントは、コールトゥアクションボタンをクリックして、このコンポーネントを通じてインスタント入金を開始できます。

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.

## 動的コンテンツを表示する

このコンポーネントは、即時入金の使用量を増やすため、連結アカウントごとに動的コンテンツ (ヘッダー、サブヘッダー、コールトゥアクションテキスト) を表示します。コンテンツは時間に基づいて変更される場合があります (例：週末)。

さらに、このコンポーネントは Instant Payouts の適格額を常に表示します。

## 表示ロジック

### Stripe がマイナス残高を処理する責任を負う連結アカウントの場合

コンポーネントは、次の条件が満たされたときに描画されます。

- マイナス残高に対する責任は Stripe が負います ([defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-responsibilities-losses_collector) の値が `stripe` の場合)
- 連結アカウントがInstant Payoutsの適格資金を保有している([Stripeが決定](https://support.stripe.com/questions/what-are-instant-payouts-and-who-is-eligible))
- コンポーネントパラメータで、`enabled` が `true`に設定されている

それ以外の場合、コンポーネントは UI をレンダリングしません。

### 連結アカウントのマイナス残高は、プラットフォームが責任を負います。

コンポーネントは、次の条件が満たされたときに描画されます。

- プラットフォームがマイナス残高に対する責任を負います ([defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-responsibilities-losses_collector) の値が `application` の場合)
- お客様のプラットフォームは Instant Payouts のサポート対象国に所在し、連結アカウントはプラットフォームと同じ国に所在し、現地通貨を使用しています
- 連結アカウントが入金可能な売上を保有している
- コンポーネントパラメータで、`enabled` が `true`に設定されている

それ以外の場合、コンポーネントは UI をレンダリングしません。

> 返金や不審請求の申し立てによる未カバーのマイナス残高に対して責任を負い、即時入金の [リスクと適格性の管理](https://docs.stripe.com/connect/instant-payouts.md#manage-risk-and-eligibility) を担当します。さらに、`onInstantPayoutsPromotionLoaded`コールバック関数で UI をレンダリングするかどうかを決定できます。

## アカウントセッションを作成する

[アカウントセッションを作成](https://docs.stripe.com/api/account_sessions/create.md)する際、`components` パラメータで `instant_payouts_promotion` を指定して即時入金プロモーションコンポーネントを有効化します。このコンポーネントには `instant_payouts` 機能の有効化が必要です。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[instant_payouts_promotion][enabled]=true" \
  -d "components[instant_payouts_promotion][features][instant_payouts]=true"
```

## コンポーネントのレンダリング

アカウントセッションを作成し、[ConnectJSを初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions) した後、フロントエンドで即時入金プロモーションコンポーネントをレンダリングできます。このコンポーネントは、プラットフォームが連結アカウントの使用状況を追跡できるよう、2 つのオプションのコールバックハンドラーを提供します。

#### JavaScript

```js
const handlePromotionLoaded = ({promotionShown}) => {
  if (promotionShown) {
    // Logic specific to when promotion is shown (for example, track in analytics)
  } else {
    // ...
  }
};

const handleInstantPayoutCreated = ({payoutId}) => {
  console.log('Instant Payout created:', payoutId);
};

const container = document.getElementById('instant-payouts-promotion-container');
const instantPayoutsPromotion = stripeConnectInstance.create('instant-payouts-promotion');

instantPayoutsPromotion.setOnInstantPayoutsPromotionLoaded(handlePromotionLoaded);
instantPayoutsPromotion.setOnInstantPayoutCreated(handleInstantPayoutCreated);

container.appendChild(instantPayoutsPromotion);
```

#### HTML + JS

| メソッド                                 | 型                                     | 説明                                                                                 |
| ------------------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------- |
| `setOnInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | 連結アカウントでプロモーションが読み込まれたときに呼び出されます。`promotionShown` は、プロモーションが連結アカウントに表示されるかどうかを示します |
| `setOnInstantPayoutCreated`          | `({payoutId: string}) => void`        | 連結アカウントがこのコンポーネントで即時入金を開始したときに呼び出されます。`payoutId`は作成された入金の ID です                    |

#### React

| React プロパティ                       | 型                                     | 説明                                                                                 |
| --------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------- |
| `onInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | 連結アカウントでプロモーションが読み込まれたときに呼び出されます。`promotionShown` は、プロモーションが連結アカウントに表示されるかどうかを示します |
| `onInstantPayoutCreated`          | `({payoutId: string}) => void`        | 連結アカウントがこのコンポーネントで即時入金を開始したときに呼び出されます。`payoutId`は作成された入金の ID です                    |