Cost+Docs

OpenCart

Intégrez Cost+ avec votre boutique OpenCart (4.x et 3.x / ocStore 3)

OpenCart

Intégrez Cost+ comme méthode de paiement dans votre boutique OpenCart. L'extension officielle NoPayn Payment Gateway est disponible pour OpenCart 4 et OpenCart 3 / ocStore 3.

Prérequis

  • Compte marchand Cost+ actif
  • OpenCart 4.0.0.0 ou ultérieur
  • PHP 8.0 ou ultérieur
  • Accès administrateur à votre tableau de bord OpenCart
  • Compte marchand Cost+ actif
  • ocStore 3.0.x ou OpenCart 3.0.3.x
  • PHP 7.4 ou ultérieur
  • Accès administrateur à votre tableau de bord OpenCart

Méthodes de paiement prises en charge

  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Installer l'extension

Méthode A : Téléversement via le panneau d'administration (recommandé)

  1. Téléchargez la dernière release .ocmod.zip depuis GitHub
  2. Dans votre admin OpenCart, accédez à Extensions → Installer
  3. Téléversez le fichier .ocmod.zip
  4. Accédez à Extensions → Extensions → Payment
  5. Trouvez NoPayn Payment Gateway et cliquez sur Install, puis Edit

Méthode B : Téléversement manuel

  1. Téléchargez ou clonez le dépôt
  2. Copiez le contenu du dossier upload/ dans le répertoire racine de votre OpenCart
  3. Accédez à Extensions → Extensions → Payment
  4. Trouvez NoPayn Payment Gateway et cliquez sur Install, puis Edit

Architecture

OpenCart 3 utilise une architecture multi-extensions :

  • NoPayn - Global Settings — configuration partagée (clé API, statuts de commande, disponibilité des méthodes, capture manuelle, journalisation de débogage)
  • NoPayn - Card Payments — paiement par carte de crédit/débit
  • NoPayn - Apple Pay / Google Pay — paiement par portefeuille (si un seul portefeuille est activé, le libellé s'ajuste automatiquement)
  • NoPayn - Vipps MobilePay — paiement Vipps/MobilePay
  • NoPayn - Swish — paiement Swish

Méthode A : Téléversement via le panneau d'administration (recommandé)

  1. Téléchargez le fichier .ocmod.zip depuis la dernière release GitHub

Utilisez le fichier .ocmod.zip de la release — pas les téléchargements "Source code" auto-générés par GitHub, qui contiennent la structure du dépôt, pas celle de l'installateur.

  1. Dans l'admin, accédez à Extensions → Installer
  2. Téléversez le fichier .ocmod.zip
  3. Accédez à Extensions → Extensions → Payments
  4. Installez d'abord NoPayn - Global Settings
  5. Ouvrez NoPayn - Global Settings et configurez :
    • Clé API
    • Statuts de commande : terminée, en attente et annulée
    • Méthodes de paiement disponibles approuvées pour votre compte marchand
    • Optionnel : capture manuelle par carte
    • Optionnel : journalisation de débogage
  6. Installez les modules de checkout que vous souhaitez exposer :
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. Pour chaque module de checkout, définissez : Status, Geo Zone et Sort Order

Méthode B : Téléversement manuel

  1. Téléchargez ou clonez le dépôt
  2. Copiez le contenu du dossier upload/ dans le répertoire racine de votre boutique
  3. Accédez à Extensions → Extensions → Payments
  4. Suivez le même ordre d'installation que la méthode A (Global Settings d'abord, puis les modules de checkout)

2. Saisir les identifiants API

Connectez-vous au Portail marchand et accédez à Sites web, puis cliquez sur le site web que vous souhaitez connecter. Cliquez sur Intégration où vous trouverez votre clé API.

Portail marchand Cost+ affichant la clé API

Dans les paramètres NoPayn Payment Gateway, saisissez votre clé API dans le champ correspondant.

Dans NoPayn - Global Settings, saisissez votre clé API dans le champ correspondant. La clé API est partagée entre tous les modules de checkout — vous n'avez besoin de la saisir qu'une seule fois.

3. Configurer les paramètres de paiement

  1. Activez les méthodes de paiement pour lesquelles vous avez été approuvé
  2. Définissez vos statuts de commande préférés pour les paiements terminés, en attente et annulés
  3. Restreignez éventuellement les paiements par Geo Zone
  4. Définissez Status sur Enabled
  5. Cliquez sur Save

Paramètres globaux

NoPayn - Global Settings stocke toute la configuration partagée :

ParamètreDescription
API KeyVotre clé API NoPayn
Order StatusesCorrespondance des statuts : terminé, en attente et annulé
Method AvailabilityQuelles méthodes de paiement votre compte marchand est approuvé à utiliser
Manual CaptureAutoriser les paiements par carte uniquement — capturer plus tard
Debug LoggingActiver la journalisation détaillée pour le dépannage

Paramètres des modules de checkout

Chaque module de checkout a ses propres paramètres de vitrine :

ParamètreDescription
StatusActiver ou désactiver cette méthode de paiement au checkout
Geo ZoneRestreindre à des zones géographiques spécifiques
Sort OrderOrdre d'affichage sur la page de checkout

N'activez que les méthodes de paiement pour lesquelles vous avez été approuvé et avez reçu confirmation.

Flux de paiement

  1. Le client sélectionne une méthode de paiement Cost+ au checkout
  2. Le client est redirigé vers la page de paiement hébergée NoPayn
  3. Après le paiement, le client revient et le statut de la commande est mis à jour automatiquement
  4. NoPayn envoie un webhook pour la confirmation asynchrone du statut

L'extension utilise la page de paiement hébergée Cost+, ce qui signifie que les clients sont redirigés vers un formulaire de paiement sécurisé. Aucune donnée de carte sensible n'est traitée par votre serveur.

Chaque module de checkout est une extension de paiement OpenCart séparée, offrant aux clients des options radio distinctes au checkout (ex. "Card Payments", "Apple Pay & Google Pay").

  1. Le client sélectionne un libellé de méthode de paiement au checkout (ex. Card Payments)
  2. L'extension crée une commande de paiement hébergée NoPayn
  3. Le client est redirigé vers la page de paiement sécurisée NoPayn
  4. Après le paiement, le client revient et le statut de la commande est mis à jour automatiquement
  5. NoPayn envoie un webhook pour la confirmation asynchrone du statut

Le module Apple Pay / Google Pay envoie les deux méthodes dans une seule transaction afin que la page hébergée NoPayn puisse proposer les deux options de portefeuille dans un flux unique.

Mise à jour de v1.0.0 vers v2.0.0

La version 1.0.0 utilisait une méthode de checkout unique appelée "NoPayn Checkout". La version 2.0.0 passe à des modules de checkout séparés par méthode de paiement. Lors de la mise à jour :

  1. Téléversez le nouveau package
  2. Votre entrée existante "NoPayn Checkout" devient NoPayn - Global Settings
  3. Vérifiez et enregistrez les paramètres globaux
  4. Installez et activez les nouveaux modules de checkout que vous souhaitez proposer aux clients

4. 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.

modified eCommerce

Intégrez Cost+ avec votre boutique modified eCommerce via le module MMLC

Shopware

Intégrez Cost+ avec votre boutique Shopware 6 via le plugin de paiement officiel

On this page

PrérequisMéthodes de paiement prises en charge1. Installer l'extensionMéthode A : Téléversement via le panneau d'administration (recommandé)Méthode B : Téléversement manuelArchitectureMéthode A : Téléversement via le panneau d'administration (recommandé)Méthode B : Téléversement manuel2. Saisir les identifiants API3. Configurer les paramètres de paiementParamètres globauxParamètres des modules de checkoutFlux de paiementMise à jour de v1.0.0 vers v2.0.04. Tester et lancerSupport