Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
Vue d’ensemble
Navio pour WooCommerce est un plugin de passerelle de paiement qui intègre Navio avec votre boutique WooCommerce. Acceptez des paiements sécurisés en Dinars Algériens (DZD) avec une configuration minimale.Installation facile
Installation depuis un fichier ZIP - aucune programmation requise
Vérification automatique du statut
Vérifie automatiquement le statut du paiement toutes les 20 minutes
Blocs WooCommerce
Fonctionne avec les paiements classiques et par blocs
Tests en Sandbox
Testez en mode sandbox avant de passer en production
Prérequis
WordPress & WooCommerce
- WordPress 5.0 ou supérieur
- WooCommerce 4.0 ou supérieur
- PHP 7.2 ou supérieur
Compte Navio
Compte marchand actif sur app.oneclickdz.com
Configuration rapide
1. Installer le plugin
Télécharger le plugin
Téléchargez le plugin depuis GitHub
Téléverser sur WordPress
- Allez dans Extensions → Ajouter
- Cliquez sur Téléverser une extension
- Sélectionnez le fichier ZIP
- Cliquez sur Installer maintenant
2. Obtenir vos clés API
- Connectez-vous à app.oneclickdz.com
- Allez dans Paramètres API
- Copiez les deux clés :
- Clé Sandbox : Pour les tests
- Clé de production : Pour les paiements réels
3. Configurer le plugin
Activer et configurer
- Activer/Désactiver : Cochez pour activer Navio
- Titre : “Navio - OneClick Payment” (affiché aux clients)
- Description : Description du mode de paiement
Ajouter les clés API
- Clé API Sandbox : Votre clé sandbox
- Clé API Production : Votre clé de production
- Mode API : Sélectionnez “Sandbox” pour les tests
Configurer les options
- Mode de frais : Choisissez qui paie les frais de transaction
NO_FEE: Vous absorbez les frais (meilleure expérience client)SPLIT_FEE: Partage 50/50CUSTOMER_FEE: Le client paie tous les frais
- Statut de la commande : Choisissez le statut après un paiement réussi
Completed: Pour les produits numériques (livraison automatique)Processing: Pour les produits physiques (nécessite un traitement)
Tests en Sandbox
Testez toujours en mode Sandbox avant d’accepter des paiements réels
-
Passer en mode Sandbox
- Mode API :
Sandbox (Testing) - Utilisez votre clé API Sandbox
- Mode API :
-
Créer une commande test
- Allez dans votre boutique
- Ajoutez un produit au panier
- Procédez au paiement
- Sélectionnez le mode de paiement Navio
- Finalisez la commande
-
Tester le flux de paiement
- Vous serez redirigé vers la page de paiement Navio
- Effectuez le paiement de test
- Retournez à votre boutique
-
Vérifier la mise à jour de la commande
- Vérifiez le statut de la commande dans WooCommerce
- Il doit être mis à jour selon votre configuration
- Consultez les journaux du plugin : WooCommerce → Navio → Journaux d’activité
Mise en production
Lorsque vous êtes prêt à accepter des paiements réels :Passer en production
- Allez dans WooCommerce → Réglages → Paiements → Navio
- Changez le Mode API en
Production (Live) - Enregistrez les modifications
Fonctionnalités principales
Vérification automatique du statut
Le plugin vérifie automatiquement le statut du paiement toutes les 20 minutes via le cron WordPress :- Aucune intervention manuelle requise
- Les commandes se mettent à jour automatiquement à la confirmation du paiement
- Les paiements échoués sont marqués “En attente”
Vérification manuelle du statut
Les clients peuvent vérifier manuellement le statut du paiement :- Disponible sur la page de commande
- Cliquez sur le bouton “Vérifier le statut du paiement”
- Mise à jour en temps réel via AJAX
Modes de frais
| Mode | Description | Idéal pour |
|---|---|---|
| NO_FEE | Vous payez tous les frais | Meilleure expérience client |
| SPLIT_FEE | Partage 50/50 | Coût partagé |
| CUSTOMER_FEE | Le client paie | Maximiser les profits |
Structure des frais : 0% sur le solde, seulement 1% de frais de retrait
Dépannage
Passerelle de paiement non configurée
Problème : Message d’erreur lors de la passation de la commande Solution :- Vérifiez que la clé API est saisie
- Assurez-vous que la clé API correspond au mode (Sandbox/Production)
- Testez la connexion dans les paramètres du plugin
Les commandes ne se mettent pas à jour
Problème : Les commandes restent “En attente” après le paiement Solution :- Vérifiez que le cron WordPress fonctionne
- Vérifiez que la référence de paiement est enregistrée dans la commande
- Activez le mode Debug dans les paramètres du plugin
- Consultez les journaux d’activité pour les erreurs
SSL/HTTPS requis
Problème : Message d’erreur “SSL requis” Solution :- Contactez votre hébergeur pour activer SSL
- Utilisez un certificat Let’s Encrypt gratuit
- Vérifiez que l’URL du site commence par
https://
Mode Debug
Activez pour le dépannage :- Allez dans WooCommerce → Réglages → Paiements → Navio
- Cochez Activer la journalisation Debug
- Enregistrez les modifications
- Consultez les journaux dans WooCommerce → Navio → Journaux d’activité
Support & Ressources
Dépôt GitHub
Code source du plugin et problèmes
Documentation API
Référence API détaillée
Tableau de bord Navio
Gérez votre compte marchand
Contacter le support
Obtenez l’aide de notre équipe
Prochaines étapes
Meilleures pratiques Navio
Découvrez les conseils de production et les meilleures pratiques de sécurité