Werbung für sofortige Auszahlungen

Rendern Sie eine Nutzeroberfläche-Komponente für verbundene Konten, die die Möglichkeit von sofortigen Auszahlungen und den Betrag der für die sofortige Auszahlungen verfügbaren Gelder anzeigt. Connect-Konten können über diese Komponente eine Sofortauszahlung einleiten, indem sie auf die Schaltfläche Call-to-Action (CTA) klicken.

Anzeige dynamischer Inhalte

Diese Komponente zeigt dynamische Inhalte (Kopfzeile, Zwischenüberschrift, Call-to-Action-Text) pro verbundenes Konto an, um die Nutzung von sofortigen Auszahlungen zu erhöhen. Die Inhalte können sich zeitabhängig ändern (z. B. an Wochenenden).

Darüber hinaus zeigt diese Komponente immer den Betrag an, der für Instant Payouts in Frage kommt.

Anzeigelogik

Für verbundene Konten, bei denen Stripe für negative Salden verantwortlich ist

Die Komponente wird gerendert, wenn die folgenden Bedingungen erfüllt sind:

• Stripe ist für negative Salden verantwortlich (defaults.responsibilities.losses_collector hat den Wert stripe)
• Das verbundene Konto verfügt über Gelder für Instant Payouts (wie von Stripe festgelegt)
• In den Komponentenparametern ist enabled auf true gesetzt.

Andernfalls rendert die Komponente keine Nutzeroberfläche.

Für verbundene Konten, bei denen die Plattform für negative Salden verantwortlich ist

Die Komponente wird gerendert, wenn die folgenden Bedingungen erfüllt sind:

• Die Plattform ist für negative Salden verantwortlich (defaults.responsibilities.losses_collector hat den Wert application)
• Ihre Plattform und das verbundene Konto befinden sich in einem Land, in dem Instant Payouts unterstützt werden und erfüllen die Förderkriterien
• Das verbundene Konto hat Geldmittel zur Auszahlung verfügbar
• In den Komponentenparametern ist enabled auf true gesetzt.

Andernfalls rendert die Komponente keine Nutzeroberfläche.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Konto-Sitzung die Werbekomponente für Instant Payouts, indem Sie instant_payouts_promotion im Parameter components angeben. Für diese Komponente muss die Funktion instant_payouts aktiviert sein.

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

Rendern der Komponente

Nachdem Sie die Konto-Sitzung erstellt und ConnectJS initialisiert haben, können Sie die Werbekomponente für Instant Payouts im Front-End rendern. Diese Komponente bietet zwei optionale Rückruf-Handler, damit Plattformen die Nutzung verbundener Konten verfolgen können:

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