mobupay/mobupay-sylius

Passerelle de paiement Mobupay pour Sylius (Payum, offsite redirect).

v1.0.0 2026-07-23 01:15 UTC

Requires

• php: >=8.1
• mobupay/mobupay-php: ^1.0
• payum/core: ^1.7

MIT

Published on Packagist.org on 2026-07-24 04:06 UTC

README

Passerelle de paiement Mobupay pour Sylius via Payum (modèle offsite / redirect). Réutilise le SDK PHP mobupay/mobupay-php déjà publié (création de session, remboursement, vérification de signature webhook). Statut : code-complet, e2e à valider sur une instance Sylius (aucune demande NC mesurée).

Modèle

Offsite redirect, comme les autres connecteurs Mobupay (non-PSP) : à la validation de la commande, CaptureAction crée une session Mobupay et redirige l'acheteur vers la page hébergée Mobupay. À la fin du paiement, Mobupay notifie la route Payum payum_notify (NotifyAction) qui marque le paiement payé ; StatusAction mappe l'état pour Sylius.

Fichiers

Fichier	Rôle
src/MobupaySyliusPlugin.php	Bundle Symfony du plugin
src/DependencyInjection/MobupaySyliusExtension.php	Charge services.yaml
src/Resources/config/services.yaml	Enregistre la gateway factory mobupay + le form type de config
src/Form/Type/MobupayGatewayConfigurationType.php	Champs de config admin (clé API, whsec, api_base, sandbox)
src/MobupayGatewayFactory.php	Fabrique Payum (config api_key, webhook_secret, sandbox)
src/Action/CaptureAction.php	Crée la session Mobupay + HttpRedirect vers la page hébergée
src/Action/StatusAction.php	Mappe le statut stocké → statut Payum (captured/pending/failed)
src/Action/NotifyAction.php	Webhook Mobupay (signé V2) → met le paiement à jour
src/Action/RefundAction.php	Remboursement total/partiel via le SDK
composer.json	Dépendances : mobupay/mobupay-php, payum/core

Installation

1. composer require mobupay/mobupay-sylius (ou dépôt/chemin local le temps de la publication).
2. Enregistrer le bundle dans config/bundles.php :

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

3. Admin Sylius › Paiements › Nouvelle méthode → factory Mobupay → renseigner la clé API sk_… et le secret webhook whsec_… (form fourni par le plugin).
4. La route de notification Payum (payum_notify_do_unsafe, param gateway=mobupay) est l'URL webhook — gérée automatiquement par CaptureAction via le token de notification.

Reste (e2e instance Sylius)

Mapping des états de commande Sylius (paid/refunded), remboursement depuis l'admin (plugin RefundPlugin), montant en unité mineure (centimes EUR / unité XPF), tests succès/échec/annulation/remboursement.