Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
Aperçu
Gestion de compte
Configurer les dashboards des comptes
Traitement des paiements
Administration de plateforme

Payments

Affichez une liste des paiements avec les fonctionnalités d'exportation, de remboursement et de contestation.

La section Paiements affiche une liste de transactions correspondant aux paiements directs, paiements indirects et 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

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 :

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "components[payments][enabled]"=true \
  -d "components[payments][features][refund_management]"=true \
  -d "components[payments][features][dispute_management]"=true \
  -d "components[payments][features][capture_payments]"=true \
  -d "components[payments][features][destination_on_behalf_of_charge_management]"=false

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_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.

Afficher le composant de paiement

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 :

payments.js
JavaScript
React
No results
// Include this element in your HTML
const payments = stripeConnectInstance.create('payments');
container.appendChild(payments);

// Optional: specify filters to apply on load
// payments.setDefaultFilters({
//   amount: {greaterThan: 100},
//   date: {before: new Date(2024, 0, 1)},
//   status: ['partially_refunded', 'refund_pending', 'refunded'],
//   paymentMethod: 'card',});
Moyen de paiementTypeDescriptionPar défaut
setDefaultFiltersPaymentsListDefaultFiltersAu moment du chargement, affichez les paiements correspondant aux critères de filtrage. Consultez les propriétés de PaymentsListDefaultFilters.none

Définition des filtres par défaut

La définition des filtres par défaut de la liste des paiements est facultative. Si cette option est activée, elle applique tous les filtres valides et ignore les filtres non valides. Si la fonctionnalité destination_on_behalf_of_charge_management est activée, vous ne pouvez pas filtrer par état ou moyen de paiement. Ces filtres sont donc automatiquement ignorés.

Vous pouvez spécifier n’importe quelle combinaison de filtres de paiement de votre choix à l’aide de l’objet PaymentsListDefaultFilters.

Objet PaymentsListDefaultFilters

Si vous souhaitez spécifier des filtres par défaut, transmettez un objet PaymentsListDefaultFilters au mutateur setDefaultFilters. L’objet possède les propriétés suivantes. Toutes les propriétés sont facultatives.

NomTypeDescriptionExemple de valeur
amount{equals: number} | {greaterThan: number} | {lessThan: number} | {between: {lowerBound: number, upperBound: number}}Filtrez par montant du paiement (au centième près).{greaterThan: 100}
date{before: Date} | {after: Date} | {between: {start: Date; end: Date} Fournissez des objets Date pour filtrer par date. Le champ accepte n’importe quel format de date autorisé par un objet Date JavaScript. Seuls l’année, le mois et le jour sont pris en compte.{before: new Date(2024, 0, 1)}

status

Status[]

Indiquez un ou plusieurs états. Les options d’état valides sont les suivantes :

'blocked' | 'canceled' | 'disputed' | 'early_fraud_warning' | 'failed' | 'incomplete' | 'partially_refunded' | 'pending' | 'refund_pending' | 'refunded' | 'successful' | 'uncaptured'

Ce filtre est ignoré si la fonction destination_on_behalf_of_charge_management est activée.

['disputed', 'canceled']

paymentMethod

PaymentMethod

La liste complète des moyens de paiement est disponible sous le type enum de l’objet PaymentMethod. Pour savoir quels moyens de paiement sont disponibles, consultez vos paramètres des moyens de paiement.

Ce filtre est ignoré si la fonction destination_on_behalf_of_charge_management est activée.

'card'

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.

Erreur fréquente

Le retransfert d’une annulation antérieure est soumis à des restrictions sur les transferts transfrontaliers. Cela signifie que dans certains cas, il pourra être impossible de rembourser votre compte connecté. Dans ce cas, attendez que plutôt que le litige soit perdu avant de recouvrer les fonds de paiements indirects on_behalf_of par transfert transfrontalier.

Personnaliser la description

Si vous utilisez l’option destination_on_behalf_of_charge_management, les informations de paiement (y compris la description) affichées pour les paiements indirects avec l’attribut on_behalf_of correspondent au paiement créé à l’origine. Si vous souhaitez afficher une description personnalisée dans la vue détaillée du paiement pour les paiements indirects et les paiements et transferts distincts lorsque cette fonctionnalité est désactivée, procédez comme suit :

Paiements indirects

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.

  1. Recherchez l’objet Transfer que vous avez créé pour un compte en recherchant le dernier paiement créé sur l’objet PaymentIntent.
  2. Utilisez l’objet Charge pour rechercher l’objet transfer associé au paiement.
  3. Utilisez l’objet Transfer pour trouver l’ID destination_payment du transfert.
  4. Appelez l’API Update Charge pour mettre à jour la description du paiement indirect à l’aide de l’ID destination_payment.

Remarque

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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d description="My custom description"

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

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.

  1. Utilisez l’objet Transfer pour trouver l’ID destination_payment du transfert.
  2. Appelez l’API Update Charge pour mettre à jour la description du paiement indirect à l’aide de l’ID destination_payment trouvé à l’étape précédente.

Remarque

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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/charges/
{{PAYMENT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d description="My custom description"

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.

Cette page vous a-t-elle été utile ?
OuiNon