WooCommerce payment gateway for Taramoney — Mobile Money Africa
# Tara Payment Gateway for WooCommerce
Passerelle de paiement WooCommerce pour Taramoney — acceptez Orange Money, MTN MoMo, Wave et plus sur votre boutique en ligne.
---
## Fonctionnalités
- Paiement via **Orange Money, MTN MoMo, Wave, carte bancaire, WhatsApp Pay**
- Génération automatique de liens de paiement via l'API Taramoney
- Confirmation de commande automatique par **webhook** (idempotent)
- Tentatives automatiques en cas d'échec réseau (retry)
- Notifications email admin en cas d'erreur de paiement
- **Cron de réconciliation** : alerte admin si une commande reste non confirmée après 30 min
- **Actions admin** : marquer comme payé manuellement, renvoyer le lien au client
- Logo et styles intégrés sur la page checkout
- Compatible **PHP 8.2+**, **WooCommerce 6+** et **HPOS (WooCommerce 7+)**
- Régulé **COBAC** — adapté aux marchés d'Afrique centrale
---
## Prérequis
- WordPress 5.8+
- WooCommerce 6.0+
- PHP 7.4+ (8.2 recommandé)
- Un compte Taramoney Business avec une clé API
---
## Installation
1. Téléchargez le fichier `tara-woocommerce.php`
2. Dans votre back-office WordPress : **Extensions → Ajouter → Téléverser**
3. Activez l'extension
4. Allez dans **WooCommerce → Réglages → Paiements → Tara Mobile Money**
5. Remplissez vos identifiants Taramoney (voir Configuration)
---
## Configuration
| Champ | Description |
|---|---|
| **Clé API** | Votre clé API de production depuis le dashboard Taramoney |
| **Business ID** | Votre identifiant entreprise Taramoney |
| **Clé secrète Webhook** | Laisser vide (Taramoney ne signe pas les webhooks) |
| **Lien de paiement préféré** | `generalLink` recommandé |
| **Email de notification** | Reçoit les alertes en cas d'échec API |
---
## Configuration du Webhook
Copiez cette URL et configurez-la dans votre dashboard Taramoney :
```
votre-site.com
```
> **Important :** Les permaliens WordPress doivent être configurés sur **"Nom de l'article"** (Réglages → Permaliens).
---
## …