Paiements Stripe et PayPal

Les moyens de paiement se règlent dans Facturation → Paiements → Configurer. Deux passerelles sont intégrées : Stripe (carte bancaire, page de paiement Stripe Checkout avec 3-D Secure) et PayPal. Chaque passerelle affiche son URL de notification (webhook), avec un bouton pour la copier :

C’est ce webhook qui marque la facture payée et déclenche la création du service : sans lui, les paiements ne sont pas confirmés.

Proposer ce moyen de paiement ne peut être coché qu’une fois tous les champs remplis. L’Ordre d’affichage décide de l’ordre des boutons au paiement. Les secrets sont chiffrés et ne sont jamais réaffichés : laissez un champ vide pour garder la valeur enregistrée.

Stripe (carte bancaire)

1. Tableau de bord Stripe → Développeurs → Clés API : copiez la clé secrète (sk_live_…, ou une clé restreinte rk_live_…).
2. Développeurs → Webhooks → Ajouter un endpoint : collez l’URL du webhook et sélectionnez les trois événements :
   • checkout.session.completed — paiement réussi ;
   • checkout.session.async_payment_succeeded — paiements différés (prélèvements…) ;
   • charge.dispute.created — ouverture d’un litige (rétrofacturation).
3. Copiez le secret de signature de l’endpoint (whsec_…).
4. Dans Velnex : Clé secrète, Secret de signature du webhook, cochez Proposer ce moyen de paiement, enregistrez.

Mode test : il n’y a pas d’interrupteur, utilisez simplement une clé sk_test_… et un endpoint créé en mode test, puis la carte 4242 4242 4242 4242. Remplacez clé et secret de signature en passant en production.

PayPal

1. developer.paypal.com → Apps & Credentials : créez une application REST et copiez le Client ID et le Secret.
2. Dans l’application, Webhooks → Add Webhook : collez l’URL du webhook et cochez PAYMENT.CAPTURE.COMPLETED et CUSTOMER.DISPUTE.CREATED. Copiez l’ID du webhook.
3. Dans Velnex : Environnement (« Sandbox (tests) » puis « Production »), Client ID, Secret, ID du webhook, cochez Proposer ce moyen de paiement.

Le paiement est capturé par Velnex au retour du client ; le webhook sert de filet de sécurité s’il ferme la page trop tôt.

Les identifiants Sandbox et Production sont différents (application et webhook compris) : pensez à tout remplacer en passant en production.

Litiges et rétrofacturations

Quand un client conteste un paiement (événements charge.dispute.created ou CUSTOMER.DISPUTE.CREATED), Velnex :

1. marque le paiement et la facture « Contesté » ;
2. suspend les services actifs payés par cette facture (motif « litige », qui n’est jamais levé automatiquement) ;
3. envoie un e-mail « Litige sur la facture … » à l’équipe ayant la permission de gérer les factures.

Répondez au litige avec vos justificatifs sur le tableau de bord de Stripe ou PayPal. Si vous l’emportez, réactivez les services depuis la fiche du service ; sinon, laissez-les suspendus ou résiliez-les.

Remboursements

Un remboursement passe toujours par un avoir : sur une facture payée, Créer un avoir puis choisissez Rembourser via Stripe/PayPal (le remboursement est fait par l’API de la passerelle avant la création de l’avoir) ou Remboursé à part. Voir « Factures, avoirs et remboursements ».

Autres règlements

Virements, chèques et espèces s’enregistrent depuis la facture avec Marquer comme payée : moyen (Virement bancaire, Chèque, Espèces, Autre), référence et note interne. Si aucune passerelle n’est active, vos clients voient un message les invitant à vous contacter pour payer.

Dépannage

Un paiement reçu sur une facture qui n’est plus payable (annulée…) est tout de même enregistré, et l’équipe reçoit l’e-mail « Paiement inattendu sur la facture ».