Description

Ce module permet d'intégrer le système de paiement Bictorys avec les factures clients dans Odoo 18.

Fonctionnalités principales

• Génération automatique ou manuelle de liens de paiement Bictorys
• Bouton "Générer Lien de Paiement" sur les factures clients
• Champ pour afficher le lien de paiement généré
• Webhook pour recevoir les notifications de paiement
• Enregistrement automatique des paiements après confirmation
• Suivi du statut de paiement (En attente, Réussi, Échoué, Annulé)
• Support des environnements Test et Production
• Multi-société

Installation

1. Copiez le dossier bictorys_invoice_payment dans le répertoire addons de votre instance Odoo
2. Redémarrez le service Odoo
3. Activez le mode développeur dans Odoo
4. Allez dans Apps et cliquez sur "Mettre à jour la liste des applications"
5. Recherchez "Bictorys Invoice Payment" et installez le module

Configuration

1. Configuration de base

Allez dans Comptabilité → Configuration → Bictorys → Configuration et créez une nouvelle configuration :

• Nom : Nom descriptif (ex: "Production Bictorys")
• Code Marchand : Code fourni par Bictorys
• Mode : Test ou Production
• Générer automatiquement le lien : Activez si vous voulez que le lien soit généré automatiquement lors de la confirmation de la facture

2. Configuration des clés API

Environnement Test

• Clé Secrète (Test) : Votre clé API de test (format: sk_test_...)
• Clé Webhook (Test) : Votre clé webhook de test (format: whk_test_...)

Environnement Production

• Clé Secrète (Production) : Votre clé API de production (format: sk_live_...)
• Clé Webhook (Production) : Votre clé webhook de production (format: whk_live_...)

3. Configuration du Webhook

URL à configurer dans Bictorys :

https://votredomaine.com/backend/payment/bictorys/invoice

Méthode : POST
Header : X-Secret-Key avec la valeur de votre clé webhook configurée dans Odoo

Utilisation

Génération manuelle du lien de paiement

1. Créez une facture client
2. Confirmez la facture
3. Cliquez sur le bouton "Générer Lien de Paiement"
4. Le lien apparaît dans l'onglet "Paiement Bictorys"
5. Partagez ce lien avec votre client

Génération automatique

Si activé, le lien se génère automatiquement lors de la confirmation de la facture et apparaît dans l'onglet "Paiement Bictorys".

Réception du paiement

1. Le webhook reçoit la notification
2. Le paiement est automatiquement enregistré sur la facture
3. La facture est marquée comme payée
4. Un message est ajouté dans le chatter

Statuts de paiement

• En attente (pending)
• Réussi (succeeded)
• Échoué (failed)
• Annulé (cancelled)

Structure du Webhook

{
    "merchantId": "VOTRE_CODE_MARCHAND",
    "paymentReference": "INV/2024/0001",
    "status": "succeeded",
    "amount": 50000,
    "currency": "XOF",
    "transactionId": "TRX123456",
    "timestamp": "2024-01-24T10:30:00Z"
}

Headers requis : Content-Type: application/json et X-Secret-Key: votre_cle_webhook

Sécurité

• Clés API stockées de manière sécurisée
• Validation de la clé secrète à chaque webhook
• Vérification de l'origine des requêtes webhook

Dépannage

Le lien de paiement ne se génère pas

• Vérifiez que la configuration Bictorys est active
• Vérifiez les clés API
• Consultez les logs Odoo

Le webhook ne fonctionne pas

• Vérifiez que l'URL du webhook est accessible publiquement
• Clé webhook identique dans Odoo et Bictorys
• Vérifiez les logs

Support & Documentation

• Documentation Bictorys
• Logs Odoo en mode debug

Licence & Auteur

• Licence : LGPL-3
• Auteur : Votre Société
• Version : 1.0.0 — Compatible Odoo 18