Sylius

Prérequis

• Sylius 2.x (Symfony), PHP 8.1+, Composer.
• Une clé API Mobupay (sk_test_… / sk_live_…) et le secret whsec_….

Installation

Le plugin réutilise le SDK PHP mobupay/mobupay-php. Installez via Composer, puis activez le bundle.

composer require mobupay/mobupay-sylius

Enregistrez le bundle dans config/bundles.php :

Mobupay\Sylius\MobupaySyliusPlugin::class => ['all' => true],

Configuration

Dans l'administration Sylius, Paiements, Nouvelle méthode, choisissez la fabrique Mobupay, puis renseignez :

• Clé API sk_test_… et secret webhook whsec_….
• URL de base : https://api.mobupay.nc, case « Mode test » cochée pour démarrer (le bac à sable se pilote par la clé sk_test_…).

Le webhook revient sur la route Payum payum_notify du plugin (gateway mobupay) ; aucune configuration d'URL supplémentaire.

Fonctionnement

1. 1Au paiement, Sylius convertit la commande puis exécute la capture Payum.
2. 2Le plugin crée une session Mobupay et redirige l'acheteur vers la page hébergée (widget Monext).
3. 3Le client paie par carte.
4. 4Le webhook signé (vérifié via Webhook::verify) fait passer le paiement à « capturé » et la commande à « payée ».

Remboursement

Le remboursement (total ou partiel) depuis l'administration Sylius appelle l'API Mobupay via l'action de remboursement Payum du plugin.

Tester

Avec une clé sk_test_…, passez commande et payez avec la carte de test Monext 5476 4309 9999 9892 (CVV 123, expiration future). Validé de bout en bout sur Sylius 2.2.6 (paiement capturé, commande payée via webhook).