# Werbung für sofortige Auszahlungen

Zeigen Sie Werbeinhalte an, um die Sofortauszahlungskonversion für Ihre verbundenen Konten zu erhöhen.

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.

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.

## 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](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-responsibilities-losses_collector) hat den Wert `stripe`)
- Das verbundene Konto verfügt über Gelder für Instant Payouts (wie [von Stripe festgelegt](https://support.stripe.com/questions/what-are-instant-payouts-and-who-is-eligible))
- 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](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-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](https://docs.stripe.com/connect/instant-payouts.md#eligible-connected-accounts)
- Das verbundene Konto hat Geldmittel zur Auszahlung verfügbar
- In den Komponentenparametern ist `enabled` auf `true` gesetzt.

Andernfalls rendert die Komponente keine Nutzeroberfläche.

> Sie haften für ungedeckte Negativsalden, die durch Rückerstattungen oder Anfechtungen entstanden sind und sind für die [Verwaltung des Risikos und der Anspruchsberechtigung](https://docs.stripe.com/connect/instant-payouts.md#manage-risk-and-eligibility) für Instant Payouts verantwortlich. Außerdem können Sie in der Rückruf-Funktion `onInstantPayoutsPromotionLoaded` festlegen, ob die Nutzeroberfläche gerendert wird.

## Kontositzung erstellen

Aktivieren Sie beim [Erstellen einer Konto-Sitzung](https://docs.stripe.com/api/account_sessions/create.md) die Aktionskomponente 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
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"
```

## Rendern der Komponente

Nachdem Sie die Konto-Sitzung erstellt und [ConnectJS initialisiert haben](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), 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:

#### 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

| Methode                              | Typ                                   | Beschreibung                                                                                                                                                      |
| ------------------------------------ | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `setOnInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | Wird aufgerufen, wenn die Werbeaktion für das verbundene Konto geladen wird. `promotionShown` gibt an, ob die Werbeaktion für das verbundene Konto angezeigt wird |
| `setOnInstantPayoutCreated`          | `({payoutId: string}) => void`        | Wird aufgerufen, wenn das verbundene Konto eine Sofortauszahlung in dieser Komponente initiiert. `payoutId` ist die ID der erstellten Auszahlung                  |

#### React

| React-Eigenschaft                 | Typ                                   | Beschreibung                                                                                                                                                      |
| --------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `onInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | Wird aufgerufen, wenn die Werbeaktion für das verbundene Konto geladen wird. `promotionShown` gibt an, ob die Werbeaktion für das verbundene Konto angezeigt wird |
| `onInstantPayoutCreated`          | `({payoutId: string}) => void`        | Wird aufgerufen, wenn das verbundene Konto eine Sofortauszahlung in dieser Komponente initiiert. `payoutId` ist die ID der erstellten Auszahlung                  |