> ## 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.

# Plugin WordPress/WooCommerce

> Guide de configuration rapide pour le plugin Navio WordPress/WooCommerce

## 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.

<CardGroup cols={2}>
  <Card title="Installation facile" icon="download" color="#0D9373">
    Installation depuis un fichier ZIP - aucune programmation requise
  </Card>

  <Card title="Vérification automatique du statut" icon="clock-rotate-left" color="#0D9373">
    Vérifie automatiquement le statut du paiement toutes les 20 minutes
  </Card>

  <Card title="Blocs WooCommerce" icon="cubes" color="#0D9373">
    Fonctionne avec les paiements classiques et par blocs
  </Card>

  <Card title="Tests en Sandbox" icon="flask" color="#0D9373">
    Testez en mode sandbox avant de passer en production
  </Card>
</CardGroup>

## Prérequis

<Steps>
  <Step title="WordPress & WooCommerce">
    * WordPress 5.0 ou supérieur
    * WooCommerce 4.0 ou supérieur
    * PHP 7.2 ou supérieur
  </Step>

  <Step title="Certificat SSL">
    SSL/HTTPS activé sur votre site (requis pour les paiements)
  </Step>

  <Step title="Compte Navio">
    Compte marchand actif sur [app.oneclickdz.com](https://enterprise.oneclickdz.com/)

    <Warning>
      Complétez la validation du marchand avant de créer des liens de paiement
    </Warning>
  </Step>
</Steps>

## Configuration rapide

### 1. Installer le plugin

<Steps>
  <Step title="Télécharger le plugin">
    Téléchargez le plugin depuis [GitHub](https://github.com/oneclickdz/ocpay_wordpress/releases/download/v2.1.0/ocpay-gateway-2.1.0.zip)
  </Step>

  <Step title="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**
  </Step>

  <Step title="Activer">
    Cliquez sur **Activer l'extension** après l'installation
  </Step>
</Steps>

### 2. Obtenir vos clés API

1. Connectez-vous à [app.oneclickdz.com](https://enterprise.oneclickdz.com/)
2. Allez dans Paramètres API
3. Copiez les deux clés :
   * **Clé Sandbox** : Pour les tests
   * **Clé de production** : Pour les paiements réels

<Warning>
  N'exposez jamais vos clés API dans du code public ni ne les partagez par e-mail
</Warning>

### 3. Configurer le plugin

<Steps>
  <Step title="Ouvrir les paramètres">
    Allez dans **WooCommerce → Réglages → Paiements**
  </Step>

  <Step title="Sélectionner Navio">
    Cliquez sur **Navio** dans la liste des modes de paiement
  </Step>

  <Step title="Activer et configurer">
    * **Activer/Désactiver** : Cochez pour activer Navio
    * **Titre** : "Navio - OneClick Payment" (affiché aux clients)
    * **Description** : Description du mode de paiement
  </Step>

  <Step title="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
  </Step>

  <Step title="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/50
      * `CUSTOMER_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)
  </Step>

  <Step title="Enregistrer les paramètres">
    Cliquez sur **Enregistrer les modifications**
  </Step>
</Steps>

## Tests en Sandbox

<Note>
  Testez toujours en mode Sandbox avant d'accepter des paiements réels
</Note>

1. **Passer en mode Sandbox**
   * Mode API : `Sandbox (Testing)`
   * Utilisez votre clé API Sandbox

2. **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

3. **Tester le flux de paiement**
   * Vous serez redirigé vers la page de paiement Navio
   * Effectuez le paiement de test
   * Retournez à votre boutique

4. **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 :

<Steps>
  <Step title="Passer en production">
    * Allez dans **WooCommerce → Réglages → Paiements → Navio**
    * Changez le **Mode API** en `Production (Live)`
    * Enregistrez les modifications
  </Step>

  <Step title="Vérifier SSL">
    Assurez-vous que SSL/HTTPS est correctement configuré sur votre site
  </Step>

  <Step title="Commande test">
    Créez une petite commande test pour vérifier que tout fonctionne
  </Step>
</Steps>

## 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       |

<Info>
  **Structure des frais** : 0% sur le solde, seulement 1% de frais de retrait
</Info>

## 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** :

1. Vérifiez que le cron WordPress fonctionne
2. Vérifiez que la référence de paiement est enregistrée dans la commande
3. Activez le mode Debug dans les paramètres du plugin
4. 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 :

1. Allez dans **WooCommerce → Réglages → Paiements → Navio**
2. Cochez **Activer la journalisation Debug**
3. Enregistrez les modifications
4. Consultez les journaux dans **WooCommerce → Navio → Journaux d'activité**

<Warning>
  Désactivez le mode debug en production pour de meilleures performances
</Warning>

## Support & Ressources

<CardGroup cols={2}>
  <Card title="Dépôt GitHub" icon="github" href="https://github.com/oneclickdz/Ocpay_wordpress">
    Code source du plugin et problèmes
  </Card>

  <Card title="Documentation API" icon="book" href="/fr/api-reference/ocpay/create-link">
    Référence API détaillée
  </Card>

  <Card title="Tableau de bord Navio" icon="gauge" href="https://enterprise.oneclickdz.com/">
    Gérez votre compte marchand
  </Card>

  <Card title="Contacter le support" icon="headset" href="/fr/contact">
    Obtenez l'aide de notre équipe
  </Card>
</CardGroup>

## Prochaines étapes

<Card title="Meilleures pratiques Navio" icon="star" href="/fr/ocpay-guides/4-best-practices">
  Découvrez les conseils de production et les meilleures pratiques de sécurité
</Card>