Liste des litiges

Le composant Disputes list affiche les litiges associés à un compte connecté. Chaque ligne de la liste représente un litige. Les comptes connectés peuvent cliquer sur une ligne pour afficher des informations détaillées sur le litige et les frais associés. Lorsque vous activez la fonctionnalité dispute_management, les comptes connectés peuvent prendre des mesures pour gérer les litiges, comme soumettre des preuves ou accepter des litiges. Le composant comprend également une fonctionnalité permettant de filtrer les litiges en fonction de critères spécifiques et d’exporter la liste des litiges à des fins d’analyse ou d’archivage.

Lorsque vous créez une session de compte, activez ce composant en indiquant disputes_list 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 disputes_list :

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

Après avoir créé la session du compte et initialisé ConnectJS, vous pouvez afficher la liste des litiges dans le front-end :

// Include this element in your HTML
const disputesList = stripeConnectInstance.create('disputes-list');
container.appendChild(paymentDisputes);

Gestion des litiges concernant les paiements indirects

Par défaut, les composants intégrés sont plus compatibles avec les intégrations Connect qui acceptent les paiements directs. Vous pouvez permettre aux utilisateurs de consulter les litiges associés aux paiements indirects avec l’attribut on_behalf_of en activant la fonctionnalité destination_on_behalf_of_charge_management. Sinon, ce composant n’inclut pas les litiges pour ces types de paiements.

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.