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 Zahlungsverluste haftbar ist

Die Komponente wird gerendert, wenn diese Bedingungen erfüllt sind und wenn Stripe für Zahlungsverluste haftbar ist:

• 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 Zahlungsverluste haftbar ist

Die Komponente zeigt an, wann diese Bedingungen erfüllt sind und wann die Plattform für Zahlungsverluste haftbar ist:

• Ihre Plattform befindet sich in einem Land, das für Instant Payouts unterstützt wird und das verbundene Konto befindet sich im selben Land wie die Plattform und verwendet die lokale Währung
• Verbundenes Konto hat Gelder 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 (i.e. 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);