Cost+Docs

Magento

Integreer Cost+ met uw Magento-winkel (2.x en 1.9 / OpenMage LTS)

Magento

Integreer Cost+ als betaalmethode in uw Magento-winkel. De Cost+-extensie is beschikbaar voor Magento 2 (2.4.6 – 2.4.8) en Magento 1.9 (inclusief OpenMage LTS 20+).

Vereisten

  • Actief Cost+ handelaarsaccount
  • Magento 2.4.6 – 2.4.8 installatie
  • PHP 8.2 – 8.4
  • Beheerderstoegang tot uw Magento-beheerpaneel
  • SSH-toegang tot uw server (voor Composer-installatie)
  • Actief Cost+ handelaarsaccount
  • Magento 1.9.x of OpenMage LTS 20+
  • PHP 7.4 of hoger
  • Beheerderstoegang tot uw Magento-beheerpaneel
  • SSH- of FTP-toegang tot uw server

1. De extensie installeren

Methode A: Installatie via Composer (aanbevolen)

Maak verbinding met uw Magento-server via SSH en navigeer naar uw Magento-hoofdmap.

Installeer de plugin:

composer require nopayn/nopayn-magento-2

Voer de Magento-setupopdrachten uit:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Als u in productiemodus bent, voer dan ook uit:

php bin/magento setup:static-content:deploy

Methode B: Handmatige installatie

  1. Navigeer naar uw app/code-directory
  2. Download en pak de Cost+-release van GitHub uit
  3. Voer de setupopdrachten uit:
php bin/magento setup:upgrade
php bin/magento cache:clean

In productiemodus:

php bin/magento setup:static-content:deploy

Download of kloon de module van GitHub.

Kopieer de inhoud van app/ naar uw Magento-hoofdmap app/:

cp -r app/* /path/to/magento/app/

Wis de Magento-cache:

rm -rf var/cache/*

Log in op het Magento-beheerpaneel en navigeer naar System → Configuration → Sales → Payment Methods om te verifieren dat de sectie NoPayn Payment Gateway verschijnt.

De module maakt een nopayn_transactions-tabel aan in uw database om betalingstransacties bij te houden. Deze wordt automatisch aangemaakt bij eerste gebruik.

2. De plugin configureren

  1. Ga naar Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Voer uw API-sleutel in (zie stap 3 hieronder)
  3. Schakel de betaalmethoden in waarvoor u bent goedgekeurd
  4. Sla de wijzigingen op
  1. Ga naar System → Configuration → Sales → Payment Methods
  2. Zoek de sectie NoPayn Payment Gateway
  3. Voer uw API-sleutel in (zie stap 3 hieronder)
  4. Schakel individuele betaalmethoden in (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Beperk optioneel per land
  6. Sla de configuratie op

3. API-gegevens invoeren

Log in op het handelaarsportaal en navigeer naar Websites, klik vervolgens op de website die u wilt verbinden. Klik op Integration waar u uw API-sleutel vindt.

Cost+ handelaarsportaal met API-sleutel

Plak de API-sleutel in het configuratieveld en sla op.

Activeer alleen de betaalmethoden waarvoor u bent goedgekeurd en een bevestiging heeft ontvangen.

Ondersteunde betaalmethoden

KassanaamNoPayn-identifier
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Betalingsflow

  1. Klant selecteert een betaalmethode bij het afrekenen en plaatst de bestelling
  2. Klant wordt doorverwezen naar de NoPayn Hosted Payment Page
  3. Na betaling keert de klant terug en wordt de bestellingsstatus automatisch bijgewerkt
  4. NoPayn stuurt een webhook voor asynchrone statusbevestiging
  1. Klant selecteert een betaalmethode bij het afrekenen en plaatst de bestelling
  2. Bestelling wordt aangemaakt met status Pending Payment
  3. Klant wordt doorverwezen naar de beveiligde NoPayn-betaalpagina
  4. Na betaling:
    • Geslaagd — klant keert terug, status geverifieerd via API, bestelling ingesteld op Processing
    • Geannuleerd — klant keert terug, bestelling ingesteld op Canceled
    • Verlopen (5 minuten time-out) — webhook wordt afgevuurd, bestelling ingesteld op Canceled
  5. NoPayn stuurt een webhook voor asynchrone statusbevestiging

Bestellingsstatusmapping

NoPayn-statusMagento-bestellingsstaatMagento-bestellingsstatus
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

De module registreert een webhook-eindpunt op /nopayn/payment/webhook. Deze URL wordt automatisch naar NoPayn gestuurd bij het aanmaken van bestellingen. De webhook verifieert altijd de bestellingsstatus via de NoPayn API voordat de Magento-bestelling wordt bijgewerkt.

Handmatige webhookconfiguratie is niet nodig — de module handelt de registratie automatisch af.

4. Uw installatie testen

  1. Doe een paar testtransacties — zowel geslaagde als mislukte
  2. Verifieer dat alle ingeschakelde betaalmethoden bij het afrekenen verschijnen
  3. Configureer het capture-gedrag (auto-capture vs. handmatig) op basis van uw verwerkingsproces

Ondersteuning

Hulp nodig? Neem contact op met ons supportteam via support@costplus.io.

On this page