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.
Comptabilité

Passerelles de paiement

Relier une passerelle de paiement (Stripe, GoCardless…) à un mode de paiement et à ses comptes, et savoir sur quel compte Dokos passe un paiement en ligne et ses frais.

Passerelles de paiement

Une Passerelle de paiement relie Dokos à un intermédiaire de paiement : Stripe, GoCardless, Stancer, PayPal… Vos clients paient en ligne une Demande de paiement envoyée depuis une facture, une commande ou un abonnement. Dokos crée alors l'écriture de paiement.

Dokos crée la passerelle quand vous configurez l'intégration. Par exemple, le compte Stripe nommé stripe du site de démonstration a créé la passerelle Stripe-stripe. La configuration de chaque intégration est décrite dans Paiements en ligne.

Les trois réglages qui donnent les comptes

Trois réglages interviennent. Configurez-les dans cet ordre.

  1. Compte Passerelle de Paiement : un par passerelle et par devise. Son Compte de Paiement est le compte comptable qui reçoit les paiements dans cette devise. Sa Devise vient de ce compte. Cochez Par défaut sur le compte à utiliser en priorité.
  2. Mode de paiement, tableau Comptes : une ligne par société, avec la Passerelle de paiement, le Compte par défaut, le Compte de frais, le Compte de taxes et le Centre de coûts. Voir Modes de paiement.
  3. Mode de paiement du client ou de l'abonnement : Dokos le reprend sur la demande de paiement et en déduit la passerelle.

Passerelles v1 et v2

Dans cette version, les passerelles suivent deux modes de comptabilisation. Vous ne choisissez pas le mode : il dépend de la passerelle.

ModePasserellesPaiement du clientFrais de la passerelle
v2Stripe, Stancer, PayPal, GoCardless, HelloAsso, Braintree, LyraÉcriture de paiement au montant brut, sur le compte d'attenteComptabilisés au versement des fonds sur votre banque
v1SumUp, Razorpay, Paytm, M-Pesa, PaymobÉcriture de paiement au montant netDéduits dans l'écriture de paiement

Avec une passerelle v2, chaque tentative de paiement crée aussi un Journal des sessions de paiement. Il montre l'état du paiement chez le prestataire.

Quel compte reçoit un paiement en ligne

Quand le client paie, Dokos crée l'écriture de paiement sur ce compte, dans cet ordre :

  1. Pour une passerelle v2 : le Clearing Account de la ligne du mode de paiement (voir plus bas).
  2. Le Compte par défaut de la ligne du mode de paiement pour la société.
  3. Sinon, le Compte de Paiement du compte passerelle de paiement de la demande.

Pour une passerelle v1, les frais retenus sont déduits du montant reçu. Dokos les inscrit dans le tableau Déductions ou pertes de l'écriture de paiement :

  • sur le Compte de frais pour les frais ;
  • sur le Compte de taxes pour la TVA sur les frais, quand la passerelle la fournit.

Dokos n'inscrit les frais que si le Compte de frais (ou le Compte de taxes) et le Centre de coûts sont renseignés sur la ligne du mode de paiement. Sinon, l'écriture de paiement est passée au montant brut.

Passerelles v2 : compte d'attente

Une passerelle v2 ne retire pas les frais au moment du paiement. Elle utilise deux colonnes que l'application Payments ajoute au tableau Comptes du mode de paiement :

  • Clearing Account : compte d'attente qui reçoit l'écriture de paiement au montant brut ;
  • Fee Tax Rate (%) : taux de TVA compris dans les frais de la passerelle. Dokos s'en sert pour séparer les frais hors taxes et la TVA.

Sur la même ligne, le Compte par défaut est le compte bancaire où le prestataire verse les fonds. Il doit être lié à un Compte bancaire de la société.

Quand la passerelle verse les fonds sur votre banque, Dokos enregistre un Versement. À sa validation, il passe une écriture de journal qui solde le compte d'attente :

CompteDébitCrédit
Compte par défaut (banque)montant net versé
Compte de fraisfrais hors taxes
Compte de taxesTVA sur les frais
Clearing Accountmontant brut des paiements

Dokos récupère les versements chaque jour pour Stripe, Stancer, GoCardless et PayPal, et depuis les fichiers de règlement pour Lyra. Pour GoCardless, il crée aussi l'écriture de paiement d'un paiement versé dont le webhook a échoué : voir Versements GoCardless. Pour HelloAsso et Braintree, Dokos ne récupère pas les versements : soldez le compte d'attente vous-même, par un Versement saisi à la main ou par une écriture de journal.

Le compte d'attente revient à zéro après chaque versement. Un solde restant signale un paiement ou un versement manquant.

Renseignez le Clearing Account pour une passerelle v2. Sans lui, l'écriture de paiement est passée au montant brut sur le Compte par défaut, et les frais ne sont pas comptabilisés.
Les libellés Clearing Account et Fee Tax Rate (%) ne sont pas encore traduits dans l'interface.

Exemple : Stripe pour Dokompany

Dokompany (DKY) encaisse ses abonnements par carte avec Stripe. Stripe verse les fonds chaque semaine sur le compte bancaire de la société. Stripe est une passerelle v2.

Sur le site de démonstration, l'intégration Stripe est déjà configurée. La passerelle Stripe-stripe a le Compte Passerelle de Paiement Stripe-stripe - EUR - DKY, dont le Compte de Paiement est Stripe-stripe - DKY. Le mode de paiement Carte bancaire ci-dessous n'existe pas sur le site de démonstration.

  1. La comptable crée le mode de paiement Carte bancaire. Sur la ligne Dokompany :
    • Passerelle de paiement : Stripe-stripe ;
    • Compte par défaut : 5121 - Comptes en monnaie nationale - DKY, le compte de la banque où Stripe verse les fonds ;
    • Clearing Account : Stripe-stripe - DKY, qui sert de compte d'attente ;
    • Compte de frais : 627 - Services bancaires et assimilés - DKY ;
    • Fee Tax Rate (%) : vide, car dans cet exemple Stripe ne facture pas de TVA sur ses frais ;
    • Centre de coûts : Principal - DKY.
  2. Elle choisit Carte bancaire comme mode de paiement des clients abonnés.

Un client paie une facture de 120 €. Dokos crée une écriture de paiement au montant brut :

CompteDébitCrédit
Stripe-stripe - DKY120 €
411 - Clients - DKY (tiers : le client)120 €

Quelques jours plus tard, Stripe verse 118 € sur la banque. Il a retenu 2 € de frais. Dokos récupère le versement, crée le Versement et passe l'écriture de journal :

CompteDébitCrédit
5121 - Comptes en monnaie nationale - DKY118 €
627 - Services bancaires et assimilés - DKY2 €
Stripe-stripe - DKY120 €

Le compte Stripe-stripe - DKY revient à zéro. Lors du rapprochement bancaire, la comptable rapproche l'opération de 118 € avec cette écriture de journal.

Les paiements arrivent sur un autre compte que prévu ? Pour une passerelle v2, le Clearing Account passe en premier. Ensuite, le Compte par défaut du mode de paiement passe avant le Compte de Paiement du compte passerelle. Vérifiez ces comptes.

Utiliser une passerelle

  • Factures et abonnements : créez une Demande de paiement depuis la facture, la commande ou l'abonnement. Le client paie depuis le lien reçu par e-mail.
  • Boutique en ligne : choisissez la passerelle dans les paramètres e-commerce.

Pour développer une nouvelle intégration, voir PaymentController v2.

Voir aussi