Passer au contenu principal

Les paiements dans Hyperline

Dans la plupart des cas, Hyperline gère la collecte des paiements et le rapprochement pour vous. Mais parfois, les paiements peuvent échouer pour diverses raisons, entraînant des factures impayées. Lorsqu’une facture est émise et prête à être payée, Hyperline tentera de prélever le moyen de paiement actif du client en initiant un paiement. C’est le cas d’usage de base pour les cartes de crédit et le prélèvement automatique.
Le moyen de paiement doit avoir été préalablement ajouté par le client via le checkout ou la page du portail.

Paiements par virement bancaire et rapprochement manuel 💡

Notez que si le client paie par virement bancaire, nous envoyons la facture à payer par e-mail et le rapprochement doit être effectué manuellement sur Hyperline (apprenez comment procéder sur cette page). Si vous avez connecté un PSP, aucune action n’est requise de votre part.

Erreurs et nouvelles tentatives

Dans certaines situations, un paiement peut échouer (moyen de paiement expiré, paiement refusé, problème de traitement côté banque, etc.). Pour les cas pertinents, nous tenterons de réessayer le paiement selon le calendrier suivant :
  • 2 heures après la première tentative
  • 12 heures après la deuxième tentative
  • 24 heures après la 3e tentative
Pour chaque tentative, une nouvelle transaction est créée pour la facture. Si toutes les tentatives échouent, nous marquerons la facture comme « erreur ».
Les erreurs pouvant être réessayées comprennent :
  • Fonds insuffisants : Le moyen de paiement ne dispose pas de fonds suffisants pour compléter la transaction
  • Paiements refusés : Le paiement a été refusé par l’émetteur de la carte ou la banque pour diverses raisons (y compris cartes signalées comme perdues ou volées, atteinte de la limite disponible sur le moyen, moyen de paiement sur une liste de blocage connue, violations de sécurité, indisponibilité du service bancaire, etc.)
D’autres types d’erreurs comme les moyens de paiement expirés ou invalides ne seront pas réessayés automatiquement et nécessitent une action du client pour être résolus.
Lorsqu’un client a plusieurs factures en erreur et ajoute un moyen de paiement automatisé (carte de crédit, prélèvement automatique), toutes les factures précédentes seront prélevées immédiatement.

Si vous êtes intégré techniquement

Cet état correspond au statut error sur l’API facture, et au message webhook invoice.errored.

Personnalisation des nouvelles tentatives

Le calendrier des nouvelles tentatives peut être personnalisé dans Paramètres > Paiements > Nouvelles tentatives de paiement. Vous pouvez ajouter ou supprimer des tentatives et ajuster le délai entre elles. Vous pouvez également désactiver entièrement les nouvelles tentatives de paiement si vous préférez réessayer manuellement les paiements échoués.

Erreur d’abonnement

De plus, si la facture est liée à un abonnement en cours, nous basculerons l’abonnement à un état « Erreur ». Ce comportement peut être désactivé dans Paramètres > Abonnements, permettant aux abonnements de rester actifs même si certaines factures n’ont pas été payées. Si la facture d’abonnement est marquée comme en erreur, nous considérerons l’abonnement associé comme inactif (puisque le client n’a pas réussi à vous payer), ce qui signifie que nous ne facturerons plus le client à l’avenir ni ne collecterons de paiement.
Les factures à l’état Ouverte resteront dans cet état aussi longtemps que l’abonnement est en pause.
Cela se comporte comme un abonnement en pause. Dans ce cas, nous vous offrons le choix de réactiver manuellement l’abonnement (la facture restera impayée) ou de l’annuler complètement.

Cet état correspond au statut errored sur l’API d’abonnement, et au message webhook subscription.errored. Cet état peut être utilisé pour désactiver l’accès à votre produit ou déplacer votre client vers un accès produit gratuit.

Nouvelle tentative manuelle

Si vous souhaitez réessayer manuellement le paiement d’une facture avec une transaction échouée, cliquez sur Facturer la facture dans le menu déroulant des actions de la facture.
Si le nouveau paiement réussit, la facture sera désormais payée et l’abonnement reviendra automatiquement à l’état actif si le client est toujours dans la période de l’abonnement.

Cela correspondra à un statut active sur l’API d’abonnement, et à un message webhook subscription.activated.

Notification client

Si le problème peut être résolu par votre client, par exemple parce que sa carte a expiré ou a été refusée et doit être remplacée, ou parce qu’il n’a pas suffisamment de fonds sur la carte et doit agir en conséquence, nous l’informerons par e-mail, lui indiquant qu’il peut gérer son paiement sur sa page de portail dédiée (avec un lien y pointant).

Types d’erreurs

Vous pouvez récupérer sur la facture les transactions associées avec le error_type suivant si le statut est failed :
  • authentication_required : La carte a été refusée car la transaction nécessite une authentification (par ex. 3-D Secure). Le client doit se rendre sur sa page de portail et authentifier sa carte. Si l’erreur s’est produite sur une transaction déjà authentifiée, le client doit contacter l’émetteur de sa carte pour plus d’informations.
  • payment_method_authorization_error : Une autorisation de transaction ne peut pas être créée pour diverses raisons telles que l’émetteur de la carte n’a pas pu être joint, ou la carte nécessite un PIN.
  • payment_method_declined : Le moyen de paiement a été refusé pour diverses raisons telles qu’une carte signalée comme perdue ou volée, des fonds insuffisants ou l’atteinte de la limite disponible sur le moyen pour compléter l’achat, un moyen de paiement sur une liste de blocage connue, etc.
  • payment_method_expired : Le moyen de paiement est expiré. Le client doit se rendre sur sa page de portail et changer de moyen de paiement.
  • payment_method_invalid : Le moyen de paiement est invalide, le plus souvent en raison de détails incorrects (numéro de carte/de compte, CVC, date d’expiration, code postal).
  • payment_method_not_supported : Le moyen de paiement ne prend pas en charge ce type d’achat (par ex. devise, paiement en ligne).
  • declined : Le paiement a été refusé pour diverses raisons telles qu’une violation de sécurité, un service bancaire non disponible, une transaction non autorisée, etc.
  • fraud : Le prestataire de paiement a soupçonné la transaction d’être frauduleuse et l’a bloquée. Ne communiquez pas d’informations plus détaillées à votre client, et vérifiez sur votre compte prestataire.
  • processing_error : Le paiement n’a pas pu être traité par l’émetteur pour une raison inconnue.
  • provider_error : Une erreur s’est produite lors de la prise de contact avec le prestataire de paiement pour initier la transaction.
  • unknown : Une erreur générique s’est produite du côté du prestataire de paiement.

Être notifié d’une facture/d’un abonnement en erreur pour un client

Si, en tant que marchand, vous souhaitez être notifié lorsqu’une des factures de votre client passe à un état d’erreur en raison d’un paiement échoué, vous pouvez mettre en œuvre plusieurs stratégies.

Si vous êtes à l'aise avec le webhook technique

Vous pouvez mettre en place un handler sur le message invoice.errored ou subscription.errored. Voir plus de détails sur la page webhooks.
Vous pouvez également tirer parti d’une solution no-code avec notre application Zapier native pour connecter l’outil de votre choix et déclencher une action interne de votre côté : notifier un canal Slack, modifier un état dans l’un de vos outils internes, envoyer un e-mail à une équipe spécifique, etc.