Promotion des virements instantané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.

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 pertes de paiement

Le composant est rendu lorsque ces conditions sont remplies, et lorsque Stripe est responsable des pertes de paiements :

• Le compte connecté dispose de fonds admissibles à Instant Payouts (selon les déterminations de Stripe)
• 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 pertes de paiement

Le composant indique quand ces conditions sont remplies et quand la plateforme est responsable des pertes de paiement :

• Votre plateforme se trouve dans un pays pris en charge pour Instant Payouts, 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 à virer
• Dans les paramètres du composant, enabled est défini sur true

Le composant n’affiche aucune interface utilisateur autrement.

Créer une session de compte

Lors de la création d’une session de compte, activez le composant de promotion des virements instantanés en spécifiant instant_payouts_promotion dans le paramètre composants. Ce composant nécessite l’activation de la fonctionnalité 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

Affichage du composant

Après avoir créé la session de compte et initialisé ConnectJS, 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é :

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