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