Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Paiements

Stripe

Encaisser des paiements par carte bancaire ou prélèvement SEPA avec 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

  1. Dans l'espace Passerelles de paiement, ouvrez Paramètres Stripe et créez un document.
  2. Renseignez les champs suivants :
    ChampContenu
    Nom de la passerelle de paiementNom du compte, par exemple Boutique. Il fait partie de l'URL du webhook : vous ne pourrez plus renommer le document.
    Clé publiableClé publiable fournie par Stripe.
    Clé secrèteClé secrète fournie par Stripe.
    Image d'en-têteFacultatif. Image affichée sur la page de paiement.
    URL de redirection en cas de succès / en cas d'échecFacultatif. Page où le client arrive après le paiement.
    Compte bancaireSection Banque. Compte bancaire qui reçoit les virements de Stripe. Dokos l'indique sur chaque Versement Stripe.
  3. 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.
  4. Enregistrez. Dokos vérifie la clé secrète auprès de Stripe, crée la passerelle Stripe-Boutique et remplit l'URL du webhook.
  5. Cliquez sur Webhooks > Créer des webhooks Stripe. Dokos déclare le webhook chez Stripe et enregistre la Clé secrète de webhook.
  6. Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Voir Configurer une passerelle.
Stripe envoie un webhook à Dokos quand le statut d'un paiement change. Ce changement peut prendre plusieurs secondes après le paiement. Sans webhook, Dokos ne sait pas qu'un prélèvement SEPA a abouti.

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

  1. Saisissez les clés de test de Stripe dans un document Paramètres Stripe dédié.
  2. Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle Stripe.
  3. 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.