Module DoliBinance FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

DOLIBINANCE POUR DOLIBARR

Screenshot dolibinance.png

Trouver/Acheter ce module sur le Dolistore ici : https://www.dolistore.com/fr/modules/2032-DoliBinance---Module-de-paiement-Crypto.html

Fonctionnalités

Ce module connecte votre compte Binance à votre Dolibarr. Si vous n'en avez pas encore un, suivez le lien proposé dans la page de configuration du module.

Cela vous permettra d'ajouter simplement le paiement en Bitcoin mais aussi d'accepter toute autre cryptomonnaie acceptée par Binance.

Quand un client souhaite régler en cryptomonnaie, le module utilise le cours moyen actuel lissé sur 24h de la cryptomonnaie pour le paiement de la facture à payer ainsi que l'adresse de réception de votre portefeuille binance. Le client saisit ensuite les informations de la transaction qu'il a réalisées : identifiant de transaction, adresse d'envoi, montant. Aussitôt que le dépôt arrive sur votre compte binance, la facture passe à "payée".

Vous pouvez suivre les soldes de vos actifs cryptomonnaies de votre portefeuille spot Binance directement dans Dolibarr sans avoir besoin d'utiliser l'application Binance.

A venir

Les permissions utilisateurs ne sont pas encore développées dans cette version et viendront plus tard. Toutes les fonctionnalités sont accessibles en accès libre à tout utilisateur de Dolibarr, cependant, aucune action importante n'est possible sans être administrateur.

Selon les besoins en comptabilité remontés lors de l'utilisation du module, les éléments correspondant seront automatiquement créés dans Dolibarr. N'hésitez pas à remonter vos remarques à ce sujet à Olivier Andrade Sanchez.

Configuration

Dictionnaire

Afin de proposer à vos clients un règlement en cryptomonnaie, vous devez ajouter les informations nécessaires dans le dictionnaire "Répertoire des adresses de paiement Binance" (Accueil->Configuration->Dictionnaire), les adresses de réception des cryptomonnaies que vous souhaitez accepter en paiement de vos factures.

Doc-010-dictionnary.png


Dans ce dictionnaire, veuillez ajouter les informations issues de vos différentes adresses de réception créées dans Binance (voir la documentation Binance pour cela).

Par exemple, ici, trois adresses ont été saisies (dont deux pour Bitcoin sur deux réseaux différents).

Doc-011-dictionnary.png


Comme vous le voyez, vous pouvez activer ou désactiver des cryptomonnaies sans supprimer le paramétrage réalisé.

Page de paramètres

L'utilisation de ce module impose l'existence d'un compte Binance.

Pourquoi Binance ? Parce qu'il s'agit de la place mondiale d'échange de cryptomonnaies la plus importante. Cependant attention, vous ne détenez pas les clés privée et publique du portefeuille correspondant, donc je vous conseille de n'utiliser cette plateforme que pour envoyer et recevoir des paiements ou pour faire du trading.

Si vous souhaitez sécuriser vos cryptos alors préférez un portefeuille de type "Hard wallet" comme une clé Ledger (lire l'article à ce sujet, ici).

Pour créer votre compte Binance, n'hésitez pas à utiliser notre lien de parrainnage Binance fourni sur la page de configuration du module.

Les avantages à faire partie de mes filleuls sont nombreux (utilisation d'un bot de trading spécifique entre autres, contactez moi pour plus d'informations).

Paramétrage des clés d'API

Dans un premier temps, veuillez créer vos clés d'API sur Binance en suivant la documentation "Créez vos clés d'API sur Binance" que vous trouverez sur leur site.

Dans un second temps, veuillez reporter vos clés d'API dans la page de paramètrage du module :

Doc-020-setup.png


Vous pouvez noter que le module vous donne le prix courant du Bitcoin, cryptomonnaie de référence.

Utilisation

Facturation

Vos factures standards peuvent maintenant être réglées en Cryptomonnaies !

Vous pouvez utiliser le lien de paiement fourni par Dolibarr et affiché sur votre facture :

Doc-030-use.png


Cette url peut être directement intégrée dans vos modèles d'email en utilisant la variable de substitution : __ONLINE_PAYMENT_TEXT_AND_URL__.

Page de paiement : étape 1

En suivant ce lien, votre client arrive sur la page de paiement en ligne de Dolibarr. Lors de la première étape, il choisit le couple Crypto/Réseau de son choix parmi la liste proposée :

Doc-040-use.png
Page de paiement : étape 2

Lors de la deuxième étape, on lui présente le montant actuel à payer, dans la cryptomonnaie choisie.

Il va devoir saisir les informations de la transaction qu'il a ou va réaliser (l'identifiant de transaction n'est pas obligatoire et sera obtenu plus tard sur Binance automatiquement).

Doc-050-use.png


Page de paiement : étape 3

Lors de la dernière étape, on lui présente l'enregistrement de son règlement.

Doc-060-use.png


Portefeuille Binance

Vous pouvez visualiser l'état des soldes de vos cryptomonnaies dans votre portefeuille Spot Binance en utilisant le lien "Portefeuille Binance" du menu gauche :

Doc-070-use.png


Historique des dépôts sur votre portefeuille

Vous pouvez visualiser l'historique à 90 jours des dépôts réalisés sur les adresses de dépôts que vous avez créées sur Binance en utilisant le lien de menu "Historique des dépôts sur votre portefeuille".

L'état à "1" indique une transaction validée (et donc prise en compte par le job de DoliBinance) :

Doc-080-use.png


Transactions

Les enregistrements de la page de paiement réalisés par vos clients sont listés ici, un statut à "1" indique une transaction terminée, reçue sur Binance et dont la facture correspondante est passée à "Payée" :

Doc-090-use.png


Job de validation des transaction (travaux automatisés)

Les transactions blockchain peuvent mettre plusieurs minutes avant d'être validées par le réseau correspondant, il n'est donc pas possible de laisser attendre votre client devant la page de paiement.

Nous avons choisi un traitement différé de la transcation en validant régulièrement les dépôts arrivant sur vos adresses de réception.

Le traitement est lancé si possible toutes les minutes si votre paramétrage le permet (vérfiez que la crontab est activée sur votre serveur) :

Doc-100-use.png


Le job est modifiable comme tout traitement automatisé dans Dolibarr et vous pouvez l'éditer afin de ne l'éxécuter qu'une fois par heure par exemple. Vous pouvez aussi choisir de le lancer manuellement :

Doc-110-use.png


Une fois la transaction validée sur le réseau et le job exécuté, la facture correspondante passe automatiquement à "Payée" et une note privée est ajoutée pour indiqué l'action de DoliBinance :

Doc-120-use.png


Restons en contact !

Ce module est un premier jet qui va évoluer et progresser en fonction de vos retours. N'hésitez pas à me faire part de vos idées et remarques à oandrade@aplose.fr.