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

Stancer

Encaisser des paiements par carte bancaire ou prélèvement SEPA avec Stancer.

Stancer

L'intégration avec Stancer 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 Stancer y est autorisé.
  • Comptabiliser chaque virement de Stancer, avec ses frais, ses remboursements et ses litiges.

Aucune donnée de carte ou de compte bancaire n'est enregistrée dans Dokos. Dokos garde l'identifiant du client Stancer, dans la fiche client.

Prérequis

  • Un compte Stancer et ses clés d'API : la clé publique et la clé privée. Vous les trouvez dans votre espace Stancer.
  • Un site servi en HTTPS. Stancer refuse une adresse de retour en HTTP.
  • Des paiements en euros, en dollars américains ou en livres sterling.

Configurer Stancer

  1. Dans l'espace Passerelles de paiement, ouvrez Paramètres Stancer et créez un document.
  2. Renseignez les champs suivants :
    ChampContenu
    Nom de la passerelle de paiementNom du compte, par exemple Stancer. Dokos crée la passerelle Stancer-Stancer.
    Clé publiqueClé publique fournie par Stancer.
    Clé privéeClé privée fournie par Stancer.
    Carte de débit/créditCochez pour accepter les cartes.
    Prélèvement SepaCochez pour accepter le prélèvement SEPA.
  3. Enregistrez. Si aucune méthode de paiement n'est cochée, Dokos affiche « Veuillez sélectionner au moins une méthode de paiement ».
  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.

Déclarer les webhooks

Les webhooks informent Dokos du résultat des paiements. Il faut le droit d'écriture sur le document Paramètres Stancer.

  1. Dans Paramètres Stancer, ouvrez le menu Webhooks, puis cliquez sur Create Stancer Webhooks.
  2. Dokos déclare chez Stancer l'adresse https://votre-site.fr/api/method/payments.webhooks.handle?gateway=Stancer-<Nom de la passerelle de paiement> et remplit la Clé secrète de webhook.

Le menu Webhooks propose aussi Show Stancer Webhooks, qui affiche l'adresse attendue et les webhooks déclarés, et Delete Stancer Webhooks, qui les supprime chez Stancer.

Autoriser Stancer sur le site e-commerce

Si l'application Webshop est installée, ouvrez les Paramètres e-commerce. Ajoutez le mode de paiement Stancer 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

  • Devises acceptées : EUR, USD et GBP.
  • Montant minimum : 0,50 € en euros.

Suivi des paiements

Chaque tentative de paiement est suivie dans le Journal des sessions de paiement. Dokos interroge Stancer à intervalles réguliers pour connaître le résultat d'un paiement. Si le résultat reste inconnu après le délai prévu, Dokos crée un Problème de rapprochement de paiement.

Comptabilisation

Stancer 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 virements de Stancer des 90 derniers jours. Pour chacun, il crée un Versement qui détaille les paiements, les remboursements, les litiges et les frais. À sa validation, Dokos passe une écriture de journal qui comptabilise les frais et solde le compte d'attente. Si le montant du virement ne correspond pas à son détail, ou si un litige n'est pas encore déduit d'un virement, Dokos crée un Problème de rapprochement de paiement.

Voir Passerelles de paiement.

Exemple

Exemple fictif : Dokompany encaisse ses factures avec la passerelle Stancer-Stancer. Un client paie une facture de 120 € par le lien de la demande de paiement. Dokos passe 120 € sur le compte d'attente du mode de paiement Stancer. Stancer vire ensuite le net, frais déduits. À la récupération quotidienne suivante, Dokos crée le Versement, comptabilise les frais et solde le compte d'attente.

Tester

  1. Saisissez les clés de test de Stancer dans un document Paramètres Stancer dédié.
  2. Créez une commande client ou une facture de vente, puis une demande de paiement avec la passerelle Stancer.
  3. Validez la demande de paiement. Ouvrez le lien de paiement dans une fenêtre de navigation privée.