Payments
Affichez une liste des paiements avec les fonctionnalités d'exportation, de remboursement et de contestation.
Affiche une liste de transactions pour les paiements directs, les paiements indirects et les paiements et transferts distincts du compte connecté.
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.
Créer une session de compte![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Lors de la création d’une session de compte, activez le composant de paiement intégré en spécifiant payments
dans le paramètre components
. Vous pouvez activer ou désactiver une fonctionnalité du composant de paiement en spécifiant le paramètre features
sous payments
:
Le composant payments 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_
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.on_ behalf_ of_ charge_ management
Autoriser vos comptes connectés à gérer les paiements indirects![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Lorsque vous attribuez la valeur true
à la fonctionnalité destination_
, 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_
, vos comptes connectés peuvent participer directement à la gestion de leurs litiges.
L’activation de la fonctionnalité de destination_
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.
Afficher le composant de paiement![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Après avoir créé la session du compte et initialisé ConnectJS, vous pouvez générer le rendu du composant de paiement dans le front-end :
Gestion des litiges concernant les paiements indirects![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_
et destination_
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_
.
Personnaliser la description![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Afin d’afficher une description personnalisée dans la vue détaillée du paiement pour les paiements indirects et les paiements et transferts distincts, procédez comme suit :
Paiements indirects![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour mettre à jour la description d’un objet Payment visible par les utilisateurs de votre plateforme, vous devez utiliser l’API Stripe. Cela concerne toutes les plateformes qui utilisent les paiements indirects.
- Recherchez l’objet Transfer que vous avez créé pour un compte en recherchant le dernier paiement créé sur l’objet PaymentIntent.
- Utilisez l’objet Charge pour rechercher l’objet transfer associé au paiement.
- Utilisez l’objet Transfer pour trouver l’ID destination_payment du transfert.
- Appelez l’API Update Charge pour mettre à jour la description du paiement indirect à l’aide de l’ID
destination_
.payment
Note
L’objet destination_payment appartient au compte connecté, vous devez donc définir l’en-tête Stripe-Account sur l’ID du compte connecté pour effectuer cet appel.
Cette description apparaît sur le paiement une fois que vous avez saisi ce champ.
En savoir plus sur la création de paiements indirects sur votre plateforme
Paiements et transferts distincts![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour mettre à jour la description d’un objet Payment visible par les utilisateurs de votre plateforme, vous devez utiliser l’API Stripe. Cela concerne les plateformes qui utilisent les paiements et transferts distincts.
- Utilisez l’objet Transfer pour trouver l’ID destination_payment du transfert.
- Appelez l’API Update Charge pour mettre à jour la description du paiement indirect à l’aide de l’ID
destination_
trouvé à l’étape précédente.payment
Note
L’objet destination_payment appartient au compte connecté, vous devez donc définir l’en-tête Stripe-Account sur l’ID du compte connecté pour effectuer cet appel.
Cette description apparaît sur le paiement une fois que vous avez saisi ce champ.
En savoir plus sur la création de paiements et transferts distincts.