Skip to Content
Plugins e-commerceWooCommerce

Plugin WooCommerce

Version 2.0 prête pour pilote production contrôlé

Télécharger WooCommerce 2.0.0 · Checksums SHA-256

Le plugin Kadryza Pay pour WooCommerce prépare les paiements Airtel Money et Moov Money depuis une boutique XAF, puis redirige le client vers Hosted Checkout.

La version 2.0 est prête techniquement pour un pilote production contrôlé. Son ZIP est installé et testé automatiquement sur WordPress 7.1.3, WooCommerce 11.2.1 et PHP 8.3 avec HPOS et Checkout Blocks. L’activation live reste individuelle : compte marchand autorisé, webhook signé configuré et parcours complet validé avec une clé test.

Parcours de paiement

  1. WooCommerce crée un Hosted Checkout pour la commande.
  2. La commande passe à En attente.
  3. Le client choisit Airtel Money ou Moov Money sur Kadryza.
  4. Kadryza vérifie le paiement et envoie un webhook signé.
  5. Seul payment_session.succeeded marque la commande payée.

payment_session.under_review maintient la commande en attente. Le retour du navigateur vers la boutique n’est jamais une preuve de paiement.

Contrats utilisés

POST /v1/hosted-checkouts
GET /v1/payment-sessions/by-reference?reference=…

La clé API doit posséder write_transactions et read_transactions. Le plugin n’appelle plus POST /v1/transactions.

Les appels sortants sont limités à l’API officielle https://api.kadryza.app. Si le montant, l’environnement ou la clé change pendant une tentative, le checkout existant n’est pas réutilisé et la commande reste à vérifier manuellement.

Compatibilité prévue

  • WordPress 6.2+ ;
  • WooCommerce 8.2+ ;
  • PHP 7.4+ ;
  • checkout classique et Checkout Blocks ;
  • High-Performance Order Storage ;
  • XAF uniquement.

Webhooks et réconciliation

Le webhook public vérifie le HMAC-SHA256 du corps brut, l’identifiant stable de l’événement, la référence, le montant, la devise et l’environnement. Les événements dupliqués sont ignorés et une commande déjà payée n’est jamais déclassée.

Une réconciliation bornée interroge aussi la Payment Session par référence. Une coupure réseau, un webhook absent ou une issue inconnue laissent la commande en attente au lieu de déclarer un faux échec.

Test et production

  • kadryza_test_… : validation sans argent réel ;
  • kadryza_live_… : utilisable uniquement après activation live du marchand, configuration du webhook et validation du parcours test ;
  • l’environnement provient de la clé et doit correspondre aux événements reçus.

Pour participer à la validation, écrivez à contact@kadryza.com.

Avant installation, vérifiez le ZIP avec le fichier SHA256SUMS publié dans le même répertoire. Installez uniquement une archive téléchargée depuis la documentation officielle Kadryza.

ShopifyPrestaShop