DocsShopware
Intégrez Cost+ avec votre boutique Shopware 6 via le plugin de paiement officiel
Intégrez Cost+ comme méthode de paiement dans votre boutique Shopware 6. Le plugin officiel NoPayn Payment prend en charge plusieurs méthodes de paiement par canal de vente et utilise le flux de page de paiement hébergée — entièrement conforme PCI DSS.
Prérequis
- Compte marchand Cost+ actif
- Shopware 6.7 ou ultérieur
- PHP 8.2 ou ultérieur
- Accès SSH ou terminal à votre serveur Shopware
Méthodes de paiement prises en charge
| Nom au checkout | Nom technique | Identifiant NoPayn |
|---|---|---|
| Credit / Debit Card | nopayn_credit_card | credit-card |
| Apple Pay | nopayn_apple_pay | apple-pay |
| Google Pay | nopayn_google_pay | google-pay |
| Vipps MobilePay | nopayn_vipps_mobilepay | vipps-mobilepay |
Chaque méthode peut être activée ou désactivée par canal de vente depuis la configuration du plugin.
1. Installer le plugin
Clonez ou copiez le plugin dans votre répertoire custom/plugins/ de Shopware :
cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPaymentPuis installez et activez via la CLI Shopware :
bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear2. Configurer le plugin
- Dans votre admin Shopware, accédez à Settings → Extensions → NoPayn Payment
- Saisissez votre clé API depuis le Portail marchand — accédez à Sites web, cliquez sur le site web que vous souhaitez connecter, puis cliquez sur Intégration pour trouver votre clé API
- Activez/désactivez les méthodes de paiement individuelles
- Enregistrez
Vous pouvez configurer une clé API différente par canal de vente si vous exploitez plusieurs vitrines.
N'activez que les méthodes de paiement pour lesquelles vous avez été approuvé et avez reçu confirmation.
3. Flux de paiement
- Le client sélectionne une méthode de paiement au checkout et passe la commande
- La commande est créée avec le statut de transaction in_progress
- Le client est redirigé vers la page de paiement hébergée NoPayn
- Après le paiement :
- Succès — le client revient, le statut est vérifié via l'API, la transaction passe à paid, la commande à processing
- Annulé — le client revient, la transaction et la commande passent à cancelled
- Expiré (délai de 5 minutes) — le webhook se déclenche, la transaction et la commande passent à cancelled
4. Correspondance des statuts de commande
| Statut NoPayn | État de la transaction | État de la commande |
|---|---|---|
new | in_progress | open |
processing | in_progress | open |
completed | paid | in_progress |
cancelled | cancelled | cancelled |
expired | cancelled | cancelled |
error | cancelled | cancelled |
5. Webhooks
Le plugin enregistre automatiquement un point d'accès webhook à /api/nopayn/webhook. Cette URL est envoyée à NoPayn lors de la création des commandes, fournissant une confirmation asynchrone du statut pour toutes les transactions.
Aucune configuration manuelle du webhook n'est nécessaire — le plugin gère l'enregistrement automatiquement.
6. Tester et lancer
Effectuez quelques transactions tests pour vous assurer que tout fonctionne correctement. Nous recommandons de tester les paiements réussis et échoués pour confirmer que tous les scénarios sont gérés correctement.
Support
Besoin d'aide ? Contactez notre équipe de support à support@costplus.io.