Rapprochement

Découvrez comment le solde du client est rapproché avec les paiements et factures

Stripe propose deux comportements de rapprochement des fonds dans le solde disponible : automatic ou manual.

Par défaut, Stripe applique le mode de rapprochement automatique au solde disponible de tous vos clients. Rendez-vous dans les paramètres de rapprochement des virements bancaires pour modifier le comportement de rapprochement pour l’ensemble de vos clients.

Paramètres de rapprochement des virements bancaires

Modifier le comportement de rapprochement

Vous pouvez utiliser le Dashboard ou l’API pour modifier les paramètres de rapprochement des virements bancaires d’un client spécifique.

Pour modifier le comportement de rapprochement d’un client dans le Dashboard :

Sélectionnez le client, puis recherchez Solde disponible dans la section Moyens de paiement.
Développez le menu déroulant () en regard des détails du solde disponible.
Dans les options qui s’affichent, sélectionnez Modifier le mode de rapprochement. Cela affiche une fenêtre modale qui vous permet de modifier le comportement de rapprochement pour le client.

La section Solde disponible sur la page Client

Pour modifier le comportement de rapprochement d’un client à l’aide de l’API, définissez le mode de rapprochement du client sur manual.

Vous pouvez rétablir le mode de rapprochement par défaut d’un client dans le Dashboard. Vous pouvez également utiliser l’API pour définir le mode de rapprochement du client sur merchant_default.

Rapprochement automatique du solde disponible

Par défaut, Stripe applique automatiquement tout solde disponible aux PaymentIntents et aux factures en attente de paiement. Un PaymentIntent est en attente de paiement s’il est incomplet. Une facture est en attente de paiement si elle est à l’état open et que sa date d’échéance n’est pas dépassée, ou elle est en retard de paiement depuis moins de 30 jours.

Stripe applique les fonds dans l’ordre suivant :

Dans un premier temps, Stripe tente de faire correspondre la référence d’un virement bancaire avec une facture unique et le numéro de facture correspondant.
Si la première tentative échoue, Stripe tente de faire correspondre la référence du virement bancaire avec un PaymentIntent unique incomplet et la référence correspondante enregistrée dans le champ display_bank_transfer_instructions du PaymentIntent.
Si Stripe ne reçoit pas de référence de virement bancaire ou si la référence ne correspond pas à une facture unique ou à un PaymentIntent, nous tentons de trouver un groupe d’une à cinq factures et PaymentIntents en attente du montant exact envoyé par l’utilisateur. Si plusieurs combinaisons sont valides, Stripe donne la priorité aux éléments suivants :
- Nous filtrons par le plus petit groupe. S’il existe deux groupes de factures ou PaymentIntents pouvant tous les deux recevoir les fonds, nous sélectionnons celui qui comporte le moins d’objets.
- S’il existe plusieurs groupes de la plus petite taille, nous sélectionnons le plus petit groupe contenant le plus de factures.
- Si plusieurs groupes contiennent le même nombre de factures, nous sélectionnons le groupe comprenant les PaymentIntents les plus anciens.
Si nous ne trouvons pas de groupe dont la somme correspond exactement aux fonds disponibles, nous payons autant de factures que possible, en commençant par les plus anciennes.
S’il reste des fonds, nous appliquons les fonds restants aux PaymentIntents incomplets, en commençant par les plus anciens.

Rapprochement manuel du solde disponible

Lorsque le rapprochement manuel est activé pour un client, Stripe n’applique pas automatiquement les fonds du solde du client.

Vous pouvez appliquer manuellement des fonds à partir du solde du client à l’aide de l’API ou du Dashboard.

Vous pouvez appliquer des fonds à un PaymentIntent incomplet, partiellement financé ou à une facture ouverte à l’aide de l’API ou du Dashboard. Vous pouvez également payer des factures encore ouvertes, mais marquées comme étant en retard à l’aide de cette méthode.

Dans le Dashboard, vous pouvez appliquer des fonds à un PaymentIntent sur la page Paiements ou sur la page du paiement en question.

Pour régler un PaymentIntent depuis la page Paiements, recherchez le paiement que vous souhaitez effectuer, cliquez sur le menu déroulant (), puis sur Payer à partir du solde de trésorerie.

Le menu déroulant pour un paiement unique sur la page Paiements du Dashboard Stripe

Pour régler un PaymentIntent à partir de la page du paiement en question, cliquez sur le bouton Payer à partir du solde de trésorerie.

Dans les deux cas, la sélection du bouton Fonds à partir du solde de trésorerie vous invite à confirmer le paiement. Ce bouton n’apparaît sur aucune des pages si le client ne dispose pas de fonds disponibles sur son solde.

Pour appliquer des fonds à une facture, accédez à la page Facture, cliquez sur le bouton Débiter le client, puis sélectionnez Solde de disponible comme moyen de paiement.

Vous pouvez financer partiellement ou totalement une facture à l’aide du Dashboard. Cette option vous permet de payer une partie de la facture, si le client ne dispose pas de fonds suffisants sur son solde disponible pour payer l’intégralité de la facture.

Pour appliquer des fonds à l’aide de l’API :

Le montant est facultatif. Si vous l’omettez, le montant sera défini par défaut sur le montant restant demandé sur le PaymentIntent.

Le code suivant est un exemple d’une passe complète de rapprochement manuel. Vous recevez le webhook cash_balance.funds_available, trouvez les PaymentIntents en attente de paiement et utilisez les fonds disponibles pour rapprocher les PaymentIntents ouverts.

L’objet envoyé dans le message cash_balance.funds_available contient toujours une représentation du solde de trésorerie du client dans son entièreté, quel que soit l’événement ayant déclenché le webhook. Cela signifie que le solde de trésorerie du client peut contenir des fonds ajoutés auparavant, en plus de ceux ajoutés juste avant l’événement déclencheur.

Sélectionner une langueRuby
Python
Node.js
Go
.NET
PHP
Java
 No results
require 'stripe'
require 'sinatra'

Stripe.api_key = 'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


post '/webhook' do
  sig_header = request.env['HTTP_STRIPE_SIGNATURE']
  endpoint_secret = ENV['ENDPOINT_SECRET']
  payload = request.body.read

  begin
    event = Stripe::Webhook.construct_event(
      payload, sig_header, endpoint_secret
    )
  rescue JSON::ParserError => e
    status 400
    return
  rescue Stripe::SignatureVerificationError => e
    status 400
    return
  end

  case event['type']
    when 'cash_balance.funds_available'
    # The cash_balance.funds_available webhook always contains a complete cash balance,
    # regardless of the event triggering the webhook.
    #
    # This means that the cash balance might contain funds that were previously added to the customer's cash balance,
    # not just those added immediately before the triggering event.
    cash_balance = event['data']['object']
    customer_id = cash_balance['customer']

    # Cash balances might contain multiple currencies.
    currencies_available = cash_balance['available'].keys

    # Getting all PaymentIntents for a customer.
    customer_payment_intents = Stripe::PaymentIntent.list({customer: customer_id})['data']

    # We can order the funding of PaymentIntents in whichever order we like - here we'd
    # like to pay the oldest first.
    customer_payment_intents = customer_payment_intents.sort_by { |payment_intent| payment_intent['created'] }

    # We allow a customer's balance to include multiple currencies.
    #
    # If a customer has balances in multiple currencies, we only allow reconciliation using the balance that matches
    # the currency of the PaymentIntent.
    intents_for_currency = {}
    currencies_available.each do |currency|
      intents_for_currency[currency] = customer_payment_intents.select do |payment_intent|
        allowed_payment_methods = payment_intent['payment_method_types']
        awaiting_further_payment = ['requires_payment_method', 'requires_action'].include? payment_intent['status']
        payment_intent['currency'] == currency.to_s and awaiting_further_payment and allowed_payment_methods.include? 'customer_balance'
      end
    end

    # Here we attempt to fund every fundable PaymentIntent for as long as there are funds available
    # in the customer's Cash Balance for the correct currency. Each time we attempt to fund a
    # PaymentIntent, we repoll the Cash Balance to make sure that we still have funds available for
    # the next PaymentIntent.
    currencies_available.each do |currency|
      payment_intents = intents_for_currency[currency]
      payment_intents.each do |payment_intent|
        if cash_balance['available'][currency] == 0
          break
        end
        Stripe::PaymentIntent.apply_customer_balance(payment_intent['id'])
        cash_balance = Stripe::Customer.retrieve_cash_balance(customer_id, nil)
      end
    end
  end
end

Fonds du solde disponible non rapprochés

Parfois, les fonds du solde disponible restent non rapprochés. Par exemple, lorsqu’un client a envoyé trop d’argent et que vous n’avez pas créé de PaymentIntents ou factures supplémentaires pour ce client.

Pour rapprocher les fonds restants sur le solde disponible du client, vous pouvez créer un nouveau PaymentIntent ou une nouvelle facture, ou renvoyer les fonds au client.

Mise en garde

Vous devez vérifier que les soldes disponibles sont rapprochés rapidement et sans erreur. Rapprochez rapidement les soldes restants des clients, plutôt que de les laisser sur votre compte durant une longue période.

Stripe envoie régulièrement des e-mails de rappel si votre compte comporte des soldes non rapprochés, afin que vous puissiez examiner ces fonds. Si le solde d’un client reste non rapproché pendant 75 jours, Stripe tente automatiquement de renvoyer les fonds vers le compte bancaire du client. Si Stripe ne dispose pas des informations sur le compte du client, elle peut contacter directement ce dernier pour initier le remboursement des fonds non rapprochés. Si Stripe ne trouve pas les informations de compte du client au bout de 90 jours, les fonds non rapprochés sont transférés sur le solde de votre compte Stripe. Contactez directement le client pour vous assurer qu’il reçoive les fonds restitués.

Vous pouvez consulter la liste complète des clients qui ont des soldes disponibles non rapprochés et la date à laquelle nous les rembourserons au client dans votre Dashboard.

Filtre des soldes restants du client

Solde créditeur

La gestion du solde créditeur est différente de celle du solde de trésorerie. Le solde créditeur du client est une fonctionnalité uniquement destinée aux factures qui représente une responsabilité entre vous et le client. Lorsqu’une facture est finalisée, le solde créditeur du client est appliqué à la facture, réduisant ainsi le montant dû.

En savoir plus sur les soldes créditeurs.