Paiements

GoCardless

Encaisser des prélèvements SEPA ponctuels ou récurrents avec 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é.
  • Rapprocher les virements de GoCardless avec les paiements qu'ils contiennent.

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

  1. Dans l'espace Passerelles de paiement, ouvrez Paramètres GoCardless et créez un document.
  2. Renseignez les champs suivants :
    ChampContenu
    Nom de la passerelle de paiementNom 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èsJeton d'accès fourni par GoCardless.
    Utiliser la sandboxCochez si le jeton vient d'un compte de test (sandbox) GoCardless.
    Compte bancaireSection Paramètres. Compte bancaire qui reçoit les virements de GoCardless. Le rapprochement bancaire automatique s'en sert.
  3. Enregistrez.
  4. 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é.

  1. Dans GoCardless, ouvrez Développeurs > Créer > Endpoint de webhook.
  2. Donnez un nom à l'endpoint et saisissez l'URL suivante :
    https://{votre_site}/api/method/payments.payment_gateways.doctype.gocardless_settings.webhooks?account={nom_du_compte}
    Remplacez {votre_site} par l'adresse de votre site, par exemple monsite.dokos.cloud. Remplacez {nom_du_compte} par le Nom de la passerelle de paiement, par exemple ABC.
  3. Laissez le champ Secret vide. GoCardless le génère.
  4. 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.

Rapprocher les virements de GoCardless

GoCardless vire les prélèvements encaissés sur votre compte bancaire. Dans le rapprochement bancaire, le bouton Rapprochement automatique rapproche ce virement avec les écritures de paiement qu'il contient. La description de la transaction bancaire doit contenir « GoCardless ». Son compte bancaire doit être le Compte bancaire des Paramètres GoCardless. Voir Rapprochement automatique.

Tester

  1. Créez un compte sandbox GoCardless et un jeton d'accès de test.
  2. Créez un document Paramètres GoCardless avec ce jeton et cochez Utiliser la sandbox.
  3. Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle GoCardless.
  4. Ouvrez le lien de paiement dans une fenêtre de navigation privée et signez le mandat avec un IBAN de test GoCardless.