Application de paiementVersion bêta privée

Découvrez comment appliquer des paiements à des factures ouvertes.

Vous pouvez appliquer des paiements à des factures ouvertes ou corriger des erreurs de rapprochement avec une application de paiement. Si vous utilisez Stripe Invoicing ou Stripe Billing et que vous recevez des paiements par virement bancaire, chèque ou en dehors de Stripe, vous devrez peut-être appliquer ou annuler manuellement des paiements vers ou depuis des factures. Vous pouvez également collecter un paiement sans utiliser de facture, puis appliquer le paiement à une facture.

Avant d’appliquer ou d’annuler l’application d’un paiement à une facture, tenez compte des points suivants :

Vous ne pouvez pas appliquer une partie d’un paiement à une facture. Vous ne pouvez appliquer un paiement entier qu’à une facture, ce qui signifie que vous ne pouvez pas appliquer un paiement à plusieurs factures.
Si certaines parties de votre intégration avec Stripe supposent qu’une facture ne peut pas être rouverte, évaluez si vous devez mettre à jour votre intégration avant de rouvrir une facture payée. Par exemple, si votre intégration dispose d’un système de comptabilité en aval, vérifiez si votre intégration est prête à gérer une facture en cours de réouverture.
Le Stripe Connector pour NetSuite ne prend pas en charge l’application des paiements sur les factures. Si vous utilisez ce connecteur et que vous rouvrez une facture, celle-ci ne sera pas rouverte dans NetSuite.

Appliquer un paiement à une facture

Vous pouvez appliquer n’importe quel paiement à une facture si le montant du paiement est inférieur ou égal au solde impayé de la facture et que la facture concerne le même client que le paiement. Si vous appliquez un paiement qui paie intégralement la facture, l’état passe à paid.

Allez dans Transactions > Paiements.
Copiez l’ID de paiement du paiement que vous souhaitez appliquer à une facture.
Accédez à la facture à laquelle vous souhaitez appliquer le paiement.
Cliquez sur le menu de débordement () et sélectionnez Appliquer le paiement.
Entrez l’ID de paiement et cliquez sur Suivant.

Vous ne pouvez pas appliquer une partie d’un paiement à une seule facture. Par exemple, vous ne pouvez pas utiliser un seul paiement pour payer plusieurs factures. Toutefois, si un paiement a été créé à partir d’un virement bancaire, vous pouvez rembourser le paiement au solde de trésorerie, puis appliquer le fonds sur différents montants de facture.

Désactivez le rapprochement automatique avant de remboursement le paiement au solde de trésorerie, afin d’éviter de rapprocher le solde vers une facture.

Annuler l’imputation d’un paiement à partir d’une facture

À partir de la vue détaillée de la facture, sous la section Paiements, vous pouvez gérer l’application de paiement. Dans ce flux, vous pouvez annuler l’imputation d’un paiement et ne pas l’appliquer, ou vous pouvez le réappliquer à une autre facture.

Allez dans la section Paiements de la facture à partir de laquelle vous souhaitez annuler l’imputation d’un paiement.
Cliquez sur le menu de débordement () du paiement, puis cliquez sur Gérer l’application.
Choisissez d’annuler l’imputation du paiement de la facture ou d’annuler l’imputation du paiement, puis de l’imputer à une autre facture ouverte.

Une fois que vous avez annulé l’imputation d’un paiement à partir d’une facture, l’état revient àopen. La facture indique Open,Past Due,Partially Paid, ouFailed (pour les factures débitées automatiquement) dans le Dashboard.

Encaissement automatique

Après avoir rouvert une facture,recouvrement automatique est désactivé par défaut. Vous pouvez vous attendre le comportement suivant lorsque vous rouvrez une facture :

Scénario	Résultat lorsque l’avance automatique est désactivée
Facture unique envoyée pour paiement	Aucun rappel envoyé
Facture unique de charge automatique	Aucune nouvelle tentative
Envoi de la facture d’abonnement pour paiement	Aucune nouvelle tentative L’état de l’abonnement ne change pas.
Facture de facturation automatique de l’abonnement	Aucun rappel envoyé L’état de l’abonnement ne change pas.

Vous pouvez activer le recouvrement automatique pour reprendre l’envoi de rappels, la nouvelle tentative de paiement échouée ou la modification des statuts facture et abonnement dans vos paramètres.

Exemples de recouvrement automatique

Les exemples ci-dessous illustrent différents scénarios d’activation du recouvrement automatique pour une facture rouverte.

Exemple 1

Vous envoyez une facture unique pour le paiement qui est dû le 1er janvier, et le client paie le 1er janvier.
Vous configurez les paramètres d’e-mail du client pour envoyer un rappel 3 jours après la date d’échéance, 5 jours après la date d’échéance et 14 jours après la date d’échéance.
La facture est rouverte le 10 janvier et le recouvrement automatique est activé ( (auto_advance = true).
Un rappel est envoyé le 14e jour, si le client n’a pas encore payé la facture.

Exemple 2

Une facture unique facturée automatiquement le 1er janvier a été payée avec succès le 1er janvier.
La planification des nouvelles tentatives est normalement de 8 Smart Retries sur 14 jours.
La facture est rouverte le 7 janvier et le recouvrement automatique est activé ( (auto_advance = true).
Smart Retries planifie les nouvelles tentatives entre le 7 et le 14 janvier.

Exemple 3

Vous envoyez une facture d’abonnement pour paiement qui doit être déposé le 1er janvier et le client est versé le 1er janvier.
Vous configurez les paramètres d’e-mail du client pour envoyer un rappel 3 jours après la date d’échéance, 5 jours après la date d’échéance et 14 jours après la date d’échéance.
Vous configurez les paramètres de l’abonnement pour annuler l’abonnement et marquer la facture commeuncollectible, si la facture est en retard de paiement de 30 jours.
La facture est rouverte le 7 janvier et le recouvrement automatique est activé ( (auto_advance = true).
Un rappel est envoyé le 14e jour, si le client n’a pas encore payé la facture.
Le 30e jour, l’abonnement est résilié et la facture marquée comme étant uncollectible, si le client n’a pas encore payé la facture.

Exemple 4

Un abonnement facturé automatiquement le 1er janvier a été payé avec succès le 1er janvier.
La planification des nouvelles tentatives est normalement de 8 Smart Retries sur 14 jours.
Vous configurez les paramètres d’abonnement paramètres pour annuler l’abonnement et marquer la facture comme étant uncollectible, si toutes les tentatives sont épuisées.
La facture est rouverte le 7 janvier et le recouvrement automatique est activé ( (auto_advance = true).
Smart Retries planifie les nouvelles tentatives entre le 7 et le 14 janvier.
Le 14e jour, l’abonnement est annulé et la facture marquée comme étant uncollectible, si le client n’a pas encore payé le facture.

État de l’abonnement

Pour les abonnements de factures, l’état de l’abonnement n’est pas affecté par l’annulation de l’application d’un paiement. Cependant, si vous activez le recouvrement automatique (auto-avance=true), toutes les actions de relance finales dans vos paramètres de récupération prendront effet à partir de la date à laquelle la facture est devenue impayée.

Notifications

Lorsque vous rouvrez une facture, aucune notification n’est envoyée directement au client. Cependant, l’état mis à jour de la facture est correctement reflété sur la Page de facture hébergée et dans lePortail client.

En savoir plus sur les impacts de la comptabilisation des revenus.

Trouver les paiements non appliqués

Tout paiement qui n’est pas appliqué à une facture est considéré comme non appliqué. Si vous avez précédemment détaché les paiements et que vous souhaitez confirmer que tous les paiements sont correctement appliqués aux factures, vous pouvez rechercher les paiements non appliqués à l’aide de l’API.

Lorsqu’un paiement se détache d’une facture, un événement invoice_payment.detached est déclenché. Vous pouvez répertorier les 30 derniers jours de ces événements.

stripe events list --type=invoice_payment.detached

Si vous utilisez Sigma ou Stripe Data Pipeline, vous pouvez trouver les paiements qui ne sont pas appliqués à une facture dans le tableau Invoice Payments ou le tableau Payments.

Suivre les paiements non appliqués

Pour suivre tous les paiements non appliqués sans utiliser le Dashboard Stripe, créez une intégration qui écoute l’événement de détachement et utilise les métadonnées pour marquer les paiements non appliqués.

Configurer des événements de webhook

Pour suivre les paiements de factures non appliqués, écoutez les événements de webhook spécifiques liés aux paiements de facture et marquez-les sur le paiement.

# Handler for webhook events
def webhook_handler(event)
  # Payment was detached
  if event.type == "invoice_payment.detached"
    invoice_payment = event.data.object
    payment_intent = invoice_payment.payment.payment_intent

    # Update metadata to track this
    Stripe::PaymentIntents.update(payment_intent, {
      metadata: {
        unapplied: true,
        unapplied_from: invoice_payment.invoice,
      }
    })
  else
    # Handle other event types if necessary
  end
end

Appliquer ou réappliquer les paiements de facture

Lorsque vous appliquez ou réimputez des paiements de facture, assurez-vous d’effacer l’état non appliqué de PaymentIntent.

Associer un objet PaymentIntent à une facture

Effacez le champ de métadonnées non appliqué

Effectuer les paiements de factures non imputées

Utilisez l’API de recherche pour répertorier tous les paiements de facture non appliqués et les afficher selon vos besoins dans votre interface utilisateur.

def render_unapplied_payments
  unapplied_payments = Stripe::PaymentIntents.search({
    query: "metadata['unapplied']:'true'"
  })

  unapplied_payments.each do |unapplied_payment|
    render :unapplied_payment,
           payment_intent: unapplied_payment.payment.payment_intent,
           unapplied_from: unapplied_payment.metadata.unapplied_from
  end
end