Détails du paiement

Ce composant est un sous-ensemble de payments, qui fournit l’overlay détaillé d’un paiement donné. Les données que le composant d’informations de paiement affiche dans l’interface utilisateur sont équivalentes à l’overlay affiché par le composant payments quand l’utilisateur clique sur une ligne de paiement.

Utilisez le composant payment-details pour appeler l’overlay d’informations de paiement sans avoir à intégrer la totalité de la liste payments sur votre site Web. Vous pouvez ainsi appeler l’overlay d’informations de paiements à partir de votre interface utilisateur existante (à partir de votre liste des paiements, par exemple) et intégrer notre vue détaillée, pour permettre à vos clients d’afficher les informations de paiement, d’effectuer des remboursements et de gérer les contestations de paiements.

Par défaut, les composants intégrés offrent des informations limitées sur les paiements indirects et les paiements et transferts distincts. Ils ne permettent pas d’accéder aux informations sur les clients, aux moyens de paiement et à certains détails sur le montant du paiement. La fonctionnalité destination_on_behalf_of_charge_management permet à un compte connecté de consulter des informations supplémentaires sur les paiements indirects, ainsi que d’effectuer des remboursements et de gérer des litiges.

Lors de la création d’une session de compte, activez les informations de paiement en spécifiant payment_details 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_details :

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[payment_details][enabled]"=true \
  -d "components[payment_details][features][refund_management]"=true \
  -d "components[payment_details][features][dispute_management]"=true \
  -d "components[payment_details][features][capture_payments]"=true \
  -d "components[payment_details][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 d’informations de paiement dans le front-end :

// Include this element in your HTML
const paymentDetails = stripeConnectInstance.create('payment-details');
paymentDetails.setPayment('{{PAYMENT_INTENT_OR_CHARGE_ID}}');
// use setOnClose to set a callback function to close payment-details
paymentDetails.setOnClose(() => {
  paymentDetails.remove();
});
container.appendChild(paymentDetails);

Le composant payment details affiche différentes informations et prend en charge différentes fonctionnalités pour différents types de paiements :

• Dans le cas des paiements directs, vos comptes connectés peuvent consulter l’ensemble des informations. Ils peuvent également gérer les remboursements et les litiges et capturer des paiements si vous activez les fonctions correspondantes lors de la création d’une session de compte.
• Dans le cas des paiements indirects et des paiements et transferts distincts, vos comptes connectés peuvent uniquement consulter l’objet du transfert associé au paiement sélectionné, qui contient des informations limitées.
• Dans le cas des paiements indirects avec l’attribut on_behalf_of, vos comptes connectés peuvent visualiser l’ensemble des informations lorsque la fonctionnalité destination_on_behalf_of_charge_management est activée. Si tel est le cas, vous pouvez également activer la gestion des remboursements et des litiges en activant les fonctionnalités correspondantes.

Autoriser vos comptes connectés à gérer les paiements indirects

Lorsque vous attribuez la valeur true à la fonctionnalité destination_on_behalf_of_charge_management, vos comptes connectés peuvent utiliser le composant de paiement pour afficher et gérer les paiement indirects qui ont l’attribut on_behalf_of. Si vous activez également la fonctionnalité dispute_management, vos comptes connectés peuvent participer directement à la gestion de leurs litiges.

L’activation de la fonctionnalité de destination_on_behalf_of_charge_management présente les limites suivantes :

1. Vous ne pouvez pas filtrer par état ou par moyen de paiement.
2. Vous ne pouvez pas exporter certaines colonnes de données.

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.

Paramètres pris en charge

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