Skip to Content
Plugins e-commercePrestaShop

Plugin PrestaShop

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

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

Le module Kadryza Pay pour PrestaShop 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 PrestaShop 8.2.8 avec PHP 8.1 et PrestaShop 9.2.0 avec PHP 8.3. L’activation live reste individuelle : marchand autorisé, webhook signé configuré et parcours complet validé avec une clé test.

Parcours de paiement

  1. PrestaShop crée un Hosted Checkout pour le panier.
  2. La commande passe à En attente de confirmation Kadryza.
  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 les permissions de création et de lecture requises. Le module n’appelle plus POST /v1/transactions. Les appels sortants utilisent uniquement https://api.kadryza.app, sans redirection HTTP.

Compatibilité

  • PrestaShop 8.2+ et 9.x ;
  • PHP 8.1+ ;
  • XAF uniquement ;
  • extension cURL ;
  • paiement externe Hosted Checkout.

Les checkouts one-page fournis par des modules tiers doivent être validés par le marchand sur sa boutique.

Webhooks et réconciliation

Le webhook 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. Elle effectue au maximum 18 tentatives espacées de 5 minutes et ne crée jamais de nouveau paiement. Une coupure réseau, un webhook absent ou une issue inconnue laissent la commande en attente.

Test et production

  • kadryza_test_... : validation sans argent réel ;
  • kadryza_live_... : utilisable après activation live du marchand, configuration du webhook et validation du parcours test ;
  • le module démarre désactivé en mode test et exige une confirmation explicite avant d’accepter le live.

Pour participer au pilote, é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.

WooCommerceOpenCart