> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saspay.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin WooCommerce

> Accepter les paiements SasPay (mobile money, carte) dans votre boutique WooCommerce en quelques minutes.

Le plugin **SasPay for WooCommerce** connecte votre boutique WordPress/WooCommerce à SasPay. Vos clients choisissent SasPay au paiement, sont redirigés vers la page de paiement hébergée SasPay, puis reviennent sur votre boutique. La commande passe à jour automatiquement grâce au retour du client et au webhook.

<Card title="Télécharger le plugin" icon="download" href="https://files.viraclip.me/saspay/docs/saspay-for-woocommerce-1.0.0.zip">
  Archive ZIP prête à téléverser dans WordPress (version 1.0.0), avec un fichier `INSTALL.txt` détaillé.
</Card>

## Prérequis

* WordPress 5.6 ou supérieur, WooCommerce 5.8 ou supérieur, PHP 7.4 ou supérieur
* Un site en HTTPS
* Un compte marchand SasPay et une clé API (`sk_test_...` pour tester, `sk_live_...` en production)

## 1. Installer le plugin

1. Dans WordPress, allez dans **Extensions → Ajouter une extension → Téléverser une extension**.
2. Choisissez le fichier `saspay-for-woocommerce-1.0.0.zip`, puis cliquez sur **Installer maintenant**.
3. Cliquez sur **Activer l'extension**.

## 2. Activer le moyen de paiement

1. Allez dans **WooCommerce → Réglages → Paiements → SasPay for WooCommerce**.
2. Cochez **Enable SasPay**.
3. Collez votre clé API dans **API Secret Key**.
4. Enregistrez les modifications.

<Warning>
  Gardez la clé secrète côté serveur uniquement : elle est stockée dans les réglages WordPress et ne doit jamais être partagée ni publiée.
</Warning>

## 3. Configurer le webhook

Le webhook permet à SasPay de prévenir votre boutique à chaque changement de statut d'un paiement.

1. Dans les réglages du plugin, copiez l'URL affichée dans **Webhook URL** (de la forme `https://votre-site.com/?wc-api=saspay_wc_webhook`).
2. Copiez la valeur du champ **Webhook Secret**.
3. Dans le [tableau de bord SasPay](https://app.saspay.me), section **Développeur → Webhooks** :
   * créez un webhook avec l'URL copiée ;
   * cochez au minimum `transaction.success` et `transaction.failed` ;
   * utilisez **Changer le secret** pour y coller la valeur de **Webhook Secret**.

<Note>
  Le secret doit être identique des deux côtés. Sinon, SasPay envoie des webhooks signés que le plugin refuse (erreur 401 dans les journaux).
</Note>

Pour le détail des événements et de la vérification de signature, voir la page [Webhooks](/api-reference/webhooks).

## 4. Tester

1. Gardez la clé `sk_test_...` dans les réglages.
2. Passez une commande de test de petit montant, puis payez avec SasPay.
3. Vérifiez que la commande passe à **Terminée**.
4. Dans le tableau de bord SasPay, déclenchez l'événement `webhook.test` de votre webhook.

Une fois les tests concluants, remplacez la clé de test par votre clé `sk_live_...`.

## Dépannage

Les événements du plugin sont consignés dans **WooCommerce → Statut → Journaux**, sous le fichier `saspay-for-woocommerce`.

| Symptôme | Cause probable |
| - | - |
| « Erreur de connexion à la plateforme de paiement » | Clé API incorrecte, ou serveur sans accès à `api.saspay.me` |
| « SasPay is not available at the moment » | Moyen de paiement désactivé, ou clé API vide |
| Webhook refusé (401) | Secret différent de celui de SasPay, ou horloge du serveur décalée de plus de 5 minutes |
| Commande non mise à jour après paiement | URL du webhook inexacte ou inaccessible depuis Internet |

Besoin d'aide ? Ouvrez un ticket depuis le [tableau de bord SasPay](https://app.saspay.me/dashboard/support).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.