Stripe
Stripe
L'intégration avec Stripe encaisse des paiements par carte bancaire ou par prélèvement SEPA.
Ce que l'intégration permet
- Payer une Demande de paiement liée à une commande client ou une facture de vente, par un lien de paiement.
- Payer une commande sur le site e-commerce, si le mode de paiement Stripe y est autorisé.
- Enregistrer le moyen de paiement du client quand la demande de paiement appartient à un abonnement. Dokos réutilise ce moyen de paiement pour les échéances suivantes.
Aucune donnée de carte ou de compte bancaire n'est enregistrée dans Dokos. Dokos garde seulement l'identifiant du client Stripe, dans la fiche client. Il réutilise ainsi le même client Stripe à chaque paiement.
Prérequis
- Un compte Stripe activé.
- La clé publiable et la clé secrète de ce compte. Dans le tableau de bord Stripe : Développeurs > Clés API.
- Les moyens de paiement que vous voulez proposer, activés dans le tableau de bord Stripe.
Configurer Stripe
- Dans l'espace Passerelles de paiement, ouvrez Paramètres Stripe et créez un document.
- Renseignez les champs suivants :
Champ Contenu Nom de la passerelle de paiement Nom du compte, par exemple Boutique. Il fait partie de l'URL du webhook : vous ne pourrez plus renommer le document.Clé publiable Clé publiable fournie par Stripe. Clé secrète Clé secrète fournie par Stripe. Image d'en-tête Facultatif. Image affichée sur la page de paiement. URL de redirection en cas de succès / en cas d'échec Facultatif. Page où le client arrive après le paiement. Compte bancaire Section Banque. Compte bancaire qui reçoit les virements de Stripe. Dokos l'indique sur chaque Versement Stripe. - Dans l'onglet Méthodes de paiement autorisées, cochez Carte et/ou Prélèvement Sepa. Ces moyens doivent aussi être activés dans le tableau de bord Stripe.
- Enregistrez. Dokos vérifie la clé secrète auprès de Stripe, crée la passerelle Stripe-Boutique et remplit l'URL du webhook.
- Cliquez sur Webhooks > Créer des webhooks Stripe. Dokos déclare le webhook chez Stripe et enregistre la Clé secrète de webhook.
- Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Voir Configurer une passerelle.
Autoriser Stripe sur le site e-commerce
Si l'application Webshop est installée, ouvrez les Paramètres e-commerce. Ajoutez le mode de paiement Stripe dans Modes de paiement autorisés. Cette section apparaît seulement si la case Activer la caisse est cochée. Voir Paramètres e-commerce.
Limites
- Le montant minimum d'un paiement dépend de la devise : 0,50 € en euros.
- La devise doit être acceptée par Stripe pour le pays de votre compte.
Suivi des paiements
Chaque tentative de paiement est suivie dans le Journal des sessions de paiement. Si un webhook n'arrive pas, Dokos interroge Stripe à intervalles réguliers pour connaître le résultat. Si le résultat reste inconnu après le délai prévu (72 heures pour un paiement par lien), Dokos crée un Problème de rapprochement de paiement.
Comptabilisation
Stripe est une passerelle v2. Dokos passe chaque paiement au montant brut sur le Clearing Account (compte d'attente) du mode de paiement. Chaque jour, Dokos récupère les versements Stripe arrivés sur votre banque. Pour chacun, il crée un Versement et une écriture de journal qui comptabilise les frais Stripe et solde le compte d'attente. Voir l'exemple Stripe.
Tester
- Saisissez les clés de test de Stripe dans un document Paramètres Stripe dédié.
- Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle Stripe.
- Validez la demande de paiement. Ouvrez le lien de paiement dans une fenêtre de navigation privée. Payez avec une carte de test Stripe.