即時入金プロモーション

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

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

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

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

表示ロジック

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

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

• マイナス残高に対する責任は Stripe が負います (defaults.responsibilities.losses_collector の値が stripe の場合)
• 連結アカウントがInstant Payoutsの適格資金を保有している(Stripeが決定)
• コンポーネントパラメータで、enabled が trueに設定されている

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

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

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

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

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

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

アカウントセッションを作成 する際、componentsパラメータで instant_payouts_promotion を指定して即時入金プロモーションコンポーネントを有効化します。このコンポーネントには instant_payouts 機能の有効化が必要です。

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}" \
  -d "components[instant_payouts_promotion][enabled]"=true \
  -d "components[instant_payouts_promotion][features][instant_payouts]"=true

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

アカウントセッションを作成し、ConnectJSを初期化 した後、フロントエンドで即時入金プロモーションコンポーネントをレンダリングできます。このコンポーネントは、プラットフォームが連結アカウントの使用状況を追跡できるよう、2 つのオプションのコールバックハンドラーを提供します。

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);