Stripe

Encaisser une facture par carte, Apple Pay, Google Pay, Bancontact, iDEAL, SEPA… Hela crée un lien de paiement Stripe pour le montant restant ; quand le client paie, le paiement est enregistré dans Hela sur le portefeuille choisi et la facture passe payée.

Connecter

Un bouton. Intégrations → Stripe → Continuer avec Stripe : vous arrivez sur l'écran de consentement de Stripe, vous choisissez votre compte, vous revenez connecté. Hela enregistre lui-même son webhook sur votre compte (checkout.session.completed, checkout.session.expired, payment_intent.payment_failed) et désigne votre premier portefeuille comme portefeuille crédité — changez-le dans les réglages si un compte bancaire « Stripe » existe. Le compte reste le vôtre, le versement aussi : Hela crée le lien et lit la réponse.

Ce bouton existe quand l'exploitant du serveur a enregistré Hela comme plateforme Stripe Connect (back-office → Intégrations et clés → Stripe Connect). Sans cela, la page propose le formulaire à clé : collez votre clé secrète (sk_live_…, ou sk_test_… pour essayer), choisissez le portefeuille ; le webhook est enregistré pour vous de la même façon, ou collez le secret whsec_… d'un endpoint à vous.

Utiliser

Sur une facture ou un devis avec un reste à payer : Lien de paiement. Hela crée une session Stripe Checkout au montant exact, dans la devise du document, et affiche l'adresse à envoyer au client (bouton Copier, ou partage WhatsApp). Le lien reste valable 24 heures.

Par l'API : POST /companies/{id}/integrations/documents/sale/{saleId}/payment-link avec { "provider": "stripe" } ; la réponse porte url.

Quand le client paie :

1. Stripe appelle l'adresse de notification ;
2. Hela enregistre un paiement sur le portefeuille, avec la référence Stripe, et émet payment.received puis invoice.paid ;
3. la carte Partenaires de la facture montre le lien payé.

Un lien expiré ou un paiement refusé émet payment.failed.

À la caisse

Le point de vente propose un mode En ligne dès qu'un fournisseur de paiement est connecté. La vente est enregistrée en attente, un QR code et un lien Stripe s'affichent sur l'écran de confirmation ; le client scanne, paie, et le webhook inscrit l'encaissement dans le portefeuille désigné. Le ticket imprimé porte En attente de paiement jusque-là.

Réglages

Réglage	Défaut	Sens
Portefeuille	—	Le portefeuille Hela crédité.
Moyens de paiement	card	Liste séparée par des virgules : card,bancontact,ideal,sepa_debit. Ils doivent être activés dans Stripe.

Bon à savoir

• Les frais Stripe ne sont pas déduits : le paiement enregistré est le montant payé par le client. Le relevé Stripe, importé en banque, porte les frais.
• Stripe exige une devise supportée par votre compte ; une facture en CDF est refusée.
• Mode test : une clé sk_test_ crée des liens de test ; les paiements enregistrés dans Hela sont alors réels dans Hela — utilisez une entreprise d'essai.