PayPal, Square, SumUp

Trois autres façons d'être payé par lien sur la facture, sur le modèle de Stripe : Hela crée la page de paiement au montant restant, le client paie, le paiement est enregistré sur le portefeuille choisi et la facture passe payée.

Fournisseur	Zone	Ce qu'il accepte	Connexion
PayPal	Monde	Compte PayPal, cartes	Client ID et secret d'une app REST (developer.paypal.com)
Square	États-Unis, Canada, Royaume-Uni, Irlande, France, Espagne, Australie, Japon	Cartes, Apple Pay, Google Pay, Cash App	Bouton Continuer avec Square ; sinon jeton d'accès (Developer Dashboard)
SumUp	Europe, Amériques	Cartes	Bouton Continuer avec SumUp ; sinon clé API (sup_sk_…) et code marchand

Connecter

Intégrations → le fournisseur → Connecter, les identifiants, et le portefeuille Hela à créditer. Puis, selon le fournisseur :

• PayPal : Developer Dashboard → Webhooks → Add webhook vers l'adresse de notification de Hela, événements CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED ; collez l'identifiant du webhook dans Hela, qui fait vérifier chaque notification par PayPal (verify-webhook-signature). Cochez bac à sable pour essayer.
• Square : par le bouton, Hela enregistre lui-même l'abonnement webhook sur votre compte et garde sa clé de signature ; rien d'autre à faire. Par le jeton : Developer Dashboard → Webhooks → Add subscription vers l'adresse de notification, événement payment.updated, collez la clé de signature. L'emplacement Square est pris au premier test (modifiable).
• SumUp : par le bouton, le code marchand est appris du compte. Rien à configurer côté webhook : Hela donne l'adresse de notification à chaque paiement créé et relit le paiement chez SumUp avant de le croire.

Les boutons existent quand l'exploitant a enregistré Hela chez Square et SumUp (back-office → Intégrations et clés).

Utiliser

Sur une facture ou un devis avec un reste à payer : Lien de paiement, choisissez le fournisseur si plusieurs sont connectés. Par l'API : POST /companies/{id}/integrations/documents/sale/{saleId}/payment-link avec { "provider": "paypal" }, "square" ou "sumup".

Quand le client paie, Hela enregistre le paiement (payment.received, invoice.paid) avec la référence du fournisseur ; un paiement refusé ou annulé émet payment.failed. PayPal est capturé par Hela à l'approbation : l'argent n'est pris qu'à ce moment, et c'est la capture qui est enregistrée.

Bon à savoir

• Les frais ne sont pas déduits du paiement enregistré ; le relevé du fournisseur, importé en banque, les porte.
• Chaque fournisseur refuse une devise qu'il ne sert pas ; la facture doit être dans une devise du compte.
• Square et SumUp sont aussi des terminaux : le lien sert au paiement à distance ; au comptoir, le terminal reste le terminal et le paiement se saisit à la caisse.