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.

For destination charges, with or without on_behalf_of, Stripe debits dispute amounts and fees from your platform account.

We recommend setting up a webhook to listen to dispute created events. When that happens, you can attempt to recover funds from the connected account by reversing the transfer through the Dashboard or by creating a transfer reversal.

If the connected account has a negative balance, Stripe attempts to debit its external account if debit_negative_balances is set to true.

If you challenge the dispute and win, you can transfer the funds that you previously reversed back to the connected account. If your platform has an insufficient balance, the transfer fails. Prevent insufficient balance errors by adding funds to your Stripe balance.

Paramètres pris en charge

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