Litiges relatifs à un paiement

Affichez un composant d’interface utilisateur pour les comptes connectés afin d’afficher les litiges applicables à un paiement spécifique. Les comptes connectés peuvent consulter les détails de chaque litige, tels que le motif, l’état, le montant et la date de création du litige. Si vous activez la fonctionnalité dispute_management pour la session de compte, le compte connecté peut effectuer des actions telles que l’envoi de preuves et l’acceptation des litiges. Cette fonctionnalité est également disponible dans le composant Informations sur le paiement.

Ce composant peut être intégré sur la même page que vos autres interfaces utilisateur de paiement. Il peut être utilisé en plein écran, en superposition, sous forme de volet ou de toute autre mise en page avec des largeurs adaptables. Si aucun litige n’est associé à un paiement donné, le composant n’affiche rien. Vous pouvez également configurer des comportements personnalisés, tels que des marges différentes, en cas d’absence de litiges. Pour ce faire, définissez une fonction de rappel personnalisée à l’aide de onDisputesLoaded.

Dans de rares cas, un compte connecté peut recevoir plusieurs litiges pour un même paiement créé par un client. Le compte connecté doit examiner et traiter séparément chaque litige relatif à un même paiement. Nous vous recommandons d’informer vos comptes connectés de cette bonne pratique afin d’améliorer leur taux de réussite des paiements.

Par défaut, les composants intégrés sont plus compatibles avec les intégrations Connect qui acceptent les paiements directs. Les composants intégrés affichent moins d’informations pour les paiements indirects et les paiements et transferts distincts, et ce composant d’interface utilisateur n’affiche rien pour ces types de paiements. Pour permettre aux utilisateurs de consulter les litiges associés aux paiements indirects avec l’attribut on_behalf_of, activez la fonctionnalité destination_on_behalf_of_charge_management.

Lorsque vous créez une session de compte, activez ce composant en indiquant payment_disputes dans le paramètre components. Vous pouvez activer ou désactiver une fonctionnalité du composant d’informations de paiement en spécifiant le paramètre features sous payment_disputes :

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payment_disputes][enabled]"=true \
  -d "components[payment_disputes][features][refund_management]"=true \
  -d "components[payment_disputes][features][dispute_management]"=true \
  -d "components[payment_disputes][features][destination_on_behalf_of_charge_management]"=false

Après avoir créé la session du compte et initialisé ConnectJS, vous pouvez générer le rendu du composant des litiges pour un composant de paiement dans le front-end :

// Include this element in your HTML
const paymentDisputes = stripeConnectInstance.create('payment-disputes');
paymentDisputes.setPayment('{{PAYMENT_INTENT_OR_CHARGE_ID}}');
container.appendChild(paymentDisputes);

Paramètres pris en charge

Ce composant intégré prend en charge les paramètres suivants :

Gestion des litiges concernant les paiements indirects

Lorsque vous activez dispute_management et destination_on_behalf_of_charge_management, vos comptes connectés peuvent mettre à jour et modifier les preuves de litiges, réfuter les litiges et accepter les litiges pour les paiements indirects disposant de l’attribut on_behalf_of.

Pour les paiements indirects, avec ou sans la valeur on_behalf_of, Stripe débite le montant du litige et les frais de votre compte de plateforme.

Nous vous recommandons de configurer un webhook pour écouter les événements créés par un litige. Dans ce cas, vous pouvez tenter de récupérer les fonds auprès du compte connecté en annulant le transfert dans le Dashboard ou en créant une annulation de transfert.

Lorsque le compte connecté a un solde négatif, Stripe tente de débiter son compte externe si debit_negative_balances est défini sur true.

Si vous contestez le litige et obtenez gain de cause, vous pouvez renvoyer le paiement précédemment annulé au compte connecté. Si le solde de votre plateforme est insuffisant, le transfert échoue. Pour éviter tout problème lié aux soldes insuffisants, ajoutez des fonds à votre solde Stripe.