# Promotion des virements instantanés

Affichez du contenu promotionnel pour augmenter le taux de conversion des virements instantanés de vos comptes connectés.

Affichez un composant d’interface utilisateur pour les comptes connectés qui affiche la possibilité d’effectuer un paiement instantané et le montant des fonds disponibles pour effectuer un paiement instantané. Les comptes connectés peuvent initier un paiement instantané via ce composant en cliquant sur le bouton d’appel à l’action.

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.

## Affichage de contenu dynamique

Ce composant affiche un contenu dynamique (en-tête, sous-en-tête, texte d’appel à l’action) par compte connecté afin d’augmenter l’utilisation des virements instantanés. Le contenu peut changer en fonction du temps (par exemple, les week-ends).

De plus, ce composant indique toujours le montant admissible pour Instant Payouts.

## Logique d’affichage

### Pour les comptes connectés pour lesquels Stripe est responsable des soldes négatifs

Le composant s’affiche lorsque les conditions suivantes sont remplies :

- Stripe est responsable des soldes négatifs ([defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-responsibilities-losses_collector) a la valeur `stripe`)
- Le compte connecté dispose de fonds admissibles à Instant Payouts (selon les [déterminations de Stripe](https://support.stripe.com/questions/what-are-instant-payouts-and-who-is-eligible))
- Dans les paramètres du composant, `enabled` est défini sur `true`

Le composant n’affiche aucune interface utilisateur autrement.

### Pour les comptes connectés pour lesquels la plateforme est responsable des soldes négatifs

Le composant s’affiche lorsque les conditions suivantes sont remplies :

- La plateforme est responsable des soldes négatifs ([defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-responsibilities-losses_collector) a la valeur `application`)
- Votre plateforme se trouve dans un pays pris en charge pour les Virements instantanés, et le compte connecté se trouve dans le même pays que la plateforme et utilise la devise locale
- Le compte connecté dispose de fonds disponibles
- Dans les paramètres du composant, `enabled` est défini sur `true`

Le composant n’affiche aucune interface utilisateur autrement.

> Vous êtes responsable des soldes négatifs non couverts causés par des remboursements ou des litiges et de la [gestion des risques et de l’admissibilité](https://docs.stripe.com/connect/instant-payouts.md#manage-risk-and-eligibility) à Instant Payouts. En outre, vous pouvez déterminer si l’interface utilisateur s’affiche dans la fonction de rappel `onInstantPayoutsPromotionLoaded`.

## Créer une session de compte

Lors de la création d’une [session Account](https://docs.stripe.com/api/account_sessions/create.md), activez le composant de promotion Instant Payouts en spécifiant `instant_payouts_promotion` dans le paramètre `components`. Ce composant nécessite que la fonctionnalité `instant_payouts` soit activée.

```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"
```

## Affichage du composant

Après avoir créé la session de compte et [initialisé ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), vous pouvez afficher le composant de promotion Instant Payouts dans le front-end. Ce composant fournit deux gestionnaires de rappel facultatifs afin que les plateformes puissent suivre l’utilisation du compte connecté&nbsp;:

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

| Moyen de paiement                    | Type                                  | Description                                                                                                                                  |
| ------------------------------------ | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `setOnInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | Appelé lors du chargement de la promotion pour le compte connecté. `promotionShown` indique si la promotion est présentée au compte connecté |
| `setOnInstantPayoutCreated`          | `({payoutId: string}) => void`        | Appelé lorsque le compte connecté initie un virement instantané dans ce composant. `payoutId` est l’ID du virement créé                      |

#### React

| Propriété React                   | Type                                  | Description                                                                                                                                  |
| --------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `onInstantPayoutsPromotionLoaded` | `({promotionShown: boolean}) => void` | Appelé lors du chargement de la promotion pour le compte connecté. `promotionShown` indique si la promotion est présentée au compte connecté |
| `onInstantPayoutCreated`          | `({payoutId: string}) => void`        | Appelé lorsque le compte connecté initie un virement instantané dans ce composant. `payoutId` est l’ID du virement créé                      |