GoCardless
GoCardless
L'intégration avec GoCardless encaisse des paiements 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. Le client signe un mandat de prélèvement sur la page GoCardless.
- Prélever les échéances suivantes d'un abonnement sur le même mandat, sans action du client.
- Payer une commande sur le site e-commerce, si le mode de paiement GoCardless y est autorisé.
- Importer les virements de GoCardless (les « payouts ») et les rapprocher avec les paiements qu'ils contiennent. Voir Versements GoCardless.
Aucune coordonnée bancaire n'est saisie dans Dokos. Dokos crée un Mandat Sepa qui reprend la référence du mandat GoCardless.
Prérequis
- Un compte GoCardless et un jeton d'accès, que vous créez dans l'espace Développeurs de GoCardless.
- Des paiements dans une devise acceptée : EUR, GBP, USD, AUD, CAD, DKK, NZD ou SEK.
Configurer GoCardless
- Dans l'espace Passerelles de paiement, ouvrez Paramètres GoCardless et créez un document.
- Renseignez les champs suivants :
Champ Contenu Nom de la passerelle de paiement Nom du compte, par exemple ABC. Dokos crée la passerelle GoCardless-ABC. Ce nom fait aussi partie de l'URL du webhook.Jeton d'accès Jeton d'accès fourni par GoCardless. Utiliser la sandbox Cochez si le jeton vient d'un compte de test (sandbox) GoCardless. Compte bancaire Section Paramètres. Compte bancaire qui reçoit les virements de GoCardless. - Enregistrez.
- Dans la section Configuration du paiement, ajoutez un compte de paiement et un mode de paiement pour chaque société. Voir Configurer une passerelle.
Configurer les webhooks
GoCardless informe Dokos de chaque changement de statut d'un mandat ou d'un paiement. Un prélèvement SEPA met plusieurs jours à aboutir : sans webhook, la demande de paiement ne passe pas à Payé.
- Dans les Paramètres GoCardless enregistrés, cliquez sur Webhooks > Copier l'URL du webhook. L'URL est aussi affichée dans le champ URL du webhook.
- Dans GoCardless, ouvrez Développeurs > Créer > Endpoint de webhook.
- Donnez un nom à l'endpoint et collez l'URL.
- Laissez le champ Secret vide. GoCardless le génère.
- Enregistrez l'endpoint, puis copiez le secret dans le champ Secret de webhook des Paramètres GoCardless.
Autoriser GoCardless sur le site e-commerce
Si l'application Webshop est installée, ouvrez les Paramètres e-commerce. Ajoutez le mode de paiement GoCardless 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.
Suivi des paiements
Chaque tentative de paiement est suivie dans le Journal des sessions de paiement. Au retour du client, Dokos enregistre le mandat et crée le prélèvement. Le prélèvement reste en cours pendant plusieurs jours, jusqu'à sa confirmation par GoCardless. Si un webhook n'arrive pas, Dokos interroge GoCardless à intervalles réguliers. Pour un prélèvement, Dokos attend 14 jours avant de créer un Problème de rapprochement de paiement.
Comptabilisation
GoCardless est une passerelle v2. Dokos passe chaque paiement au montant brut sur le Clearing Account (compte d'attente) du mode de paiement. Quand GoCardless verse les fonds, Dokos importe le virement et solde le compte d'attente. Voir Versements GoCardless et Passerelles de paiement.
Versements GoCardless
Chaque jour, Dokos interroge GoCardless et importe les virements au statut « payé ». Pour chacun, il crée un Versement qui reprend les lignes du virement, puis le valide. La validation passe l'écriture de journal qui comptabilise les frais et solde le compte d'attente.
Dokos n'importe que les virements créés depuis la première session de paiement de la passerelle. Tant que la passerelle n'a aucune session, rien n'est importé. Les virements plus anciens règlent des paiements encaissés avant les sessions de paiement, sans compte d'attente : les importer débiterait la banque une seconde fois.
Lignes d'un versement
Un virement GoCardless est la liste de ses lignes. Dokos crée une ligne de Versement par ligne GoCardless. Le type de ligne s'affiche Paiement, Frais, Remboursement, Dispute ou Adjustment (ces deux derniers libellés ne sont pas traduits) :
| Ligne GoCardless | Ligne du versement |
|---|---|
| Paiement versé | Paiement, au montant brut |
| Frais GoCardless, frais d'application ou supplément | Frais, TVA comprise. Le libellé indique le paiement concerné. |
| Remboursement | Remboursement |
| Paiement échoué ou rejeté après le versement | Dispute |
| Autre type de ligne | Adjustment |
Chaque ligne liée à un paiement est rattachée à son Journal des sessions de paiement par l'identifiant du paiement GoCardless.
Paiement versé sans écriture de paiement
Si le webhook d'un paiement n'est pas parvenu à Dokos, le paiement peut être versé sans Écriture de paiement. Avant de créer le versement, Dokos règle ce paiement :
- si le paiement a une session, Dokos le rapproche comme le fait l'interrogation périodique ;
- sinon (paiement pris sans session de paiement), Dokos lit les métadonnées du paiement chez GoCardless. Elles désignent la demande de paiement ou le document réglé, que Dokos marque comme payé.
Si une écriture de paiement existe déjà pour ce paiement, Dokos n'en crée pas d'autre. Une écriture déjà rapprochée ou annulée compte aussi : Dokos la laisse telle quelle. Si le règlement échoue, Dokos enregistre une erreur dans le Journal des erreurs et poursuit l'import du virement.
Paiement repris par GoCardless
Quand GoCardless reprend un paiement déjà versé (prélèvement échoué ou contesté), Dokos ajoute une ligne Dispute (litige) et ouvre un Problème de rapprochement de paiement de type Chargeback (libellé non traduit). Le paiement reste enregistré dans Dokos : annulez l'écriture de paiement ou contre-passez-la, puis encaissez à nouveau la facture.
Écart entre le virement et ses lignes
Les lignes d'un virement doivent totaliser le montant viré par GoCardless. Sinon, Dokos ajoute une ligne Adjustment (ajustement) du montant de l'écart, passe le Versement au statut Écart et ouvre un Problème de rapprochement de paiement de type Payout Discrepancy (libellé non traduit). Dokos ne valide pas ce versement. Vérifiez l'écart dans le tableau de bord GoCardless.
Reprise après erreur
Un virement n'est importé qu'une fois : Dokos le reconnaît à son identifiant GoCardless. Si l'import d'un virement échoue, Dokos enregistre l'erreur dans le Journal des erreurs et passe au virement suivant. Un versement créé mais non validé reste au brouillon : Dokos le valide à l'exécution suivante.
Exemple fictif
GoCardless verse 89,80 € à la société Mappemonde. Le virement contient :
| Ligne GoCardless | Montant |
|---|---|
Paiement versé (paiement PM_1) | 100,00 € |
Frais GoCardless sur PM_1, dont 0,20 € de TVA | -1,20 € |
| Remboursement d'un autre paiement | -9,00 € |
Les lignes totalisent 89,80 €, soit le montant du virement : il n'y a pas d'écart. Dokos crée un Versement de trois lignes (Paiement, Frais, Remboursement) et le valide. Si GoCardless avait annoncé 90,00 €, Dokos aurait ajouté une ligne Adjustment de 0,20 € et laissé le versement au brouillon, au statut Écart.
Tester
- Créez un compte sandbox GoCardless et un jeton d'accès de test.
- Créez un document Paramètres GoCardless avec ce jeton et cochez Utiliser la sandbox.
- Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle GoCardless.
- Ouvrez le lien de paiement dans une fenêtre de navigation privée et signez le mandat avec un IBAN de test GoCardless.