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é.
• Rapprocher les virements de Stancer avec les paiements qu'ils contiennent.

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 :

   Champ	Contenu
   Nom de la passerelle de paiement	Nom du compte, par exemple Stancer. Dokos crée la passerelle Stancer-Stancer.
   Clé publique	Clé publique fournie par Stancer.
   Clé privée	Clé privée fournie par Stancer.
   Carte de débit/crédit	Cochez pour accepter les cartes.
   Prélèvement Sepa	Cochez 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 le webhook

Sur la v5, Dokos ne crée pas le webhook chez Stancer. Déclarez-le à la main :

1. Dans votre espace Stancer, créez un webhook avec l'adresse https://votre-site.fr/api/method/payments.payment_gateways.doctype.stancer_settings.webhooks?account=<nom du document Paramètres Stancer>.
2. Copiez le secret que Stancer donne pour ce webhook dans le champ Clé secrète de webhook des Paramètres Stancer, puis enregistrez.

Dokos vérifie avec ce secret la signature de chaque notification. Sans secret, il refuse les notifications.

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.

Rapprocher les virements de Stancer

Stancer vire les paiements encaissés sur votre compte bancaire. Dans le rapprochement bancaire, le bouton Rapprochement automatique reconnaît ces virements. La description de la transaction bancaire doit contenir « ILIAD TRANS STANCER » et la référence du virement Stancer. Dokos rapproche alors le virement avec les écritures de paiement Stancer qu'il contient. Le compte bancaire de la transaction doit être le Compte par défaut du mode de paiement Stancer. Voir Rapprochement automatique.

Exemple

Sur le site de démonstration, Dokompany encaisse ses factures avec la passerelle Stancer-Stancer. Le mode de paiement Stancer a pour compte par défaut 5121 - Comptes en monnaie nationale - DKY. Une demande de paiement envoie au client un lien de paiement Stancer. Quand Stancer vire les fonds, le rapprochement automatique relie le virement aux écritures de paiement.

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.