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.
By default, the embedded components offer limited information for destination charges and separate charges and transfers. They don’t provide access to customer information, payment methods, and some charge amount details. The destination_on_behalf_of_charge_management feature allows a connected account to see additional information with destination charges, as well as perform refunds and manage disputes.
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
:
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 :
Note
Dans le cas des paiements indirects et des paiements et transferts distincts, les comptes connectés ne possèdent pas les objets d’intention de paiement associés aux paiements. Pour ces paiements, veuillez indiquer l’ID de l’objet de paiement associé au compte connecté.
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 :
- Vous ne pouvez pas filtrer par état ou par moyen de paiement.
- Vous ne pouvez pas exporter certaines colonnes de données.
Gestion des litiges concernant les paiements indirects
En cas de litige résultant d’un paiement indirect ou de paiements et transferts distincts, la plateforme est débitée du montant contesté et des commissions de plateforme. Les composants intégrés Connect n’annulent pas le transfert vers le compte connecté, quelles que soient les fonctionnalités de la session de compte. Nous vous recommandons de configurer des webhooks pour écouter les événements de litige. Lorsqu’un litige est créé, vous pouvez créer un prélèvement de compte ou une annulation de transfert vers votre compte connecté. Vous pouvez également annuler le transfert vers votre compte connecté via le Dashboard. Lorsqu’un litige est clôturé, vous pouvez alors mettre à jour le solde de votre compte connecté en fonction du résultat du litige. Si votre compte connecté a remporté le litige, vous pouvez créer un transfert pour annuler l’effet du prélèvement du compte ou de l’annulation du transfert.
Lorsque dispute_management
et destination_on_behalf_of_charge_management
sont activés, les 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
.
Paramètres pris en charge
Ce composant intégré prend en charge les paramètres suivants :