Application de paiementVersion bêta publique

Vous pouvez utiliser l’affectation des paiements pour appliquer des paiements à des factures ouvertes ou corriger des erreurs de rapprochement. Si vous utilisez Stripe Invoicing ou Stripe Billing et recevez des paiements par virement bancaire, chèque ou en dehors de Stripe, il peut être nécessaire d’appliquer ou d’annuler l’application des paiements manuellement sur les factures. Vous pouvez également encaisser un paiement sans utiliser de facture, puis l’appliquer ensuite à une facture.

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

• Vous pouvez uniquement annuler l’affectation des paiements sur des factures dont le recouvrement_method = send_facture le permet.
• Vous ne pouvez pas appliquer une partie d’un paiement à une facture. Un paiement doit être appliqué en entier à une seule facture, ce qui signifie qu’un paiement ne peut pas être réparti sur plusieurs factures.
• Si certaines parties de votre intégration avec Stripe supposent qu’une facture ne peut pas être rouverte, vérifiez si vous devez mettre à jour votre intégration avant de rouvrir une facture payée. Par exemple, si vous vous fiez aux événements Stripe pour mettre à jour un système comptable en aval, assurez-vous que votre intégration est prête à gérer le cas où une facture est rouverte.
• 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.

Imputer 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 à payé.

Vous ne pouvez pas appliquer une partie d’un paiement à une seule facture. Par exemple, un paiement unique ne peut pas régler plusieurs factures. En revanche, si un paiement a été effectué par virement bancaire, vous pouvez rembourser le paiement vers le solde en espèces puis répartir ces fonds sur différentes factures.

Désactivez le rapprochement automatique avant de rembourser 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

Depuis la vue détaillée de la facture, dans la section Paiements, vous pouvez gérer l’imputation des paiements. Dans cette vue, vous pouvez annuler l’imputation d’un paiement et le laisser non imputé, ou bien le réimputé à une autre facture.

Vous pouvez uniquement annuler un paiement via le Dashboard Stripe.

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

Après avoir annulé l’affectation d’un paiement à une facture, le statut repasse à Open. Dans le Dashboard, la facture peut apparaître comme Open, Past Due, Partially Paid, ou Failed

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 :

Vous pouvez activer le recouvrement automatique pour reprendre l’envoi des rappels, relancer les paiements échoués ou mettre à jour l’état des factures et des abonnements selon 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

• Envoyez une facture unique pour paiement dû le 1er janvier, que le client paiera 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 rouvrez la facture le 10 janvier et la collecte automatique est activée (auto_advance = true).
• Un rappel est envoyé le 14e jour, si le client n’a pas encore payé la facture.

Exemple 2

• 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.
• 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 = vrai).
• 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.

État de l’abonnement

Pour les factures d’abonnement, l’annulation de l’affectation d’un paiement n’affecte pas le statut de l’abonnement. En revanche, si vous activez la collecte automatique(auto_advance=true), toutes les actions de relance finales définies dans vos paramètres de recouvrement s’appliquent en fonction de la date de dépassement de la facture.

Notifications

Lorsque vous rouvrez une facture, aucune notification n’est envoyée automatiquement au client. En revanche, la page de facture hébergée et le portail client affichent bien l’état mis à jour de la facture.

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

Suivre les paiements non appliqués

Tout paiement qui n’est pas imputé à 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 imputés aux factures, vous pouvez rechercher les paiements non imputé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.

curl -G https://api.stripe.com/v1/events \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type="invoice_payment.detached"

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

Suivre les paiements non imputés

Pour suivre tous les paiements non imputé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 imputés.

Configurer des événements de webhook

Pour suivre les paiements de factures non imputés, écoutez les événements de webhook spécifiques liés aux paiements de facture et marquez-les directement 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

Imputer ou réimputer 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

curl https://api.stripe.com/v1/invoices/in_1MtHbELkdIwHu7ixl4OzzPMv/attach_payment \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent=pi_3MvUdLLkdIwHu7ix1nItxHNQ

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

curl https://api.stripe.com/v1/payment_intents/pi_3MvUdLLkdIwHu7ix1nItxHNQ \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "metadata[unapplied]"=false \
  -d "metadata[unapplied_from]"=

Effectuer les paiements de factures non imputées

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

curl -G https://api.stripe.com/v1/payment_intents/search \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode query="metadata['unapplied']:'true'"