Cost+Docs

Magento

Integrer Cost+ med din Magento-butik (2.x og 1.9 / OpenMage LTS)

Magento

Integrer Cost+ som betalingsmetode i din Magento-butik. Cost+-udvidelsen er tilgængelig til Magento 2 (2.4.6 – 2.4.8) og Magento 1.9 (inklusiv OpenMage LTS 20+).

Forudsætninger

  • Aktiv Cost+-forhandlerkonto
  • Magento 2.4.6 – 2.4.8-installation
  • PHP 8.2 – 8.4
  • Administratoradgang til dit Magento-adminpanel
  • SSH-adgang til din server (til Composer-installation)
  • Aktiv Cost+-forhandlerkonto
  • Magento 1.9.x eller OpenMage LTS 20+
  • PHP 7.4 eller nyere
  • Administratoradgang til dit Magento-adminpanel
  • SSH- eller FTP-adgang til din server

1. Installer udvidelsen

Metode A: Installation via Composer (anbefalet)

Forbind til din Magento-server via SSH og naviger til dit Magento-rodbibliotek.

Installer pluginet:

composer require nopayn/nopayn-magento-2

Kør Magento-opsætningskommandoer:

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

Hvis du er i produktionstilstand, skal du også køre:

php bin/magento setup:static-content:deploy

Metode B: Manuel installation

  1. Naviger til dit app/code-bibliotek
  2. Download og udpak Cost+-udgivelsen fra GitHub
  3. Kør opsætningskommandoerne:
php bin/magento setup:upgrade
php bin/magento cache:clean

Hvis i produktionstilstand:

php bin/magento setup:static-content:deploy

Download eller klon modulet fra GitHub.

Kopier indholdet af app/ ind i dit Magento-rod app/-bibliotek:

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

Ryd Magento-cachen:

rm -rf var/cache/*

Log ind på Magento-adminpanelet og naviger til System → Configuration → Sales → Payment Methods for at verificere, at sektionen NoPayn Payment Gateway vises.

Modulet opretter en nopayn_transactions-tabel i din database til sporing af betalingstransaktioner. Denne oprettes automatisk ved første brug.

2. Konfigurer pluginet

  1. Gå til Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Indtast din API-nøgle (se trin 3 nedenfor)
  3. Aktiver de betalingsmetoder, du er godkendt til
  4. Gem ændringer
  1. Gå til System → Configuration → Sales → Payment Methods
  2. Find sektionen NoPayn Payment Gateway
  3. Indtast din API-nøgle (se trin 3 nedenfor)
  4. Aktiver individuelle betalingsmetoder (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Begræns eventuelt efter land
  6. Gem konfiguration

3. Indtast API-legitimationsoplysninger

Log ind på forhandlerportalen og naviger til Websites, klik derefter på det website, du vil forbinde. Klik på Integration, hvor du finder din API-nøgle.

Cost+ forhandlerportal med API-nøgle

Indsæt API-nøglen i konfigurationsfeltet og gem.

Aktiver kun de betalingsmetoder, du er godkendt til og har modtaget bekræftelse for.

Understøttede betalingsmetoder

Checkout-navnNoPayn-identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Betalingsflow

  1. Kunden vælger en betalingsmetode ved checkout og afgiver ordren
  2. Kunden omdirigeres til NoPayn Hosted Payment Page
  3. Efter betaling vender kunden tilbage, og ordrestatus opdateres automatisk
  4. NoPayn sender en webhook til asynkron statusbekræftelse
  1. Kunden vælger en betalingsmetode ved checkout og afgiver ordren
  2. Ordren oprettes med status Pending Payment
  3. Kunden omdirigeres til den sikre NoPayn-betalingsside
  4. Efter betaling:
    • Succes — kunden vender tilbage, status verificeres via API, ordre sættes til Processing
    • Annulleret — kunden vender tilbage, ordre sættes til Canceled
    • Udløbet (5-minutters timeout) — webhook udløses, ordre sættes til Canceled
  5. NoPayn sender en webhook til asynkron statusbekræftelse

Ordrestatusmapping

NoPayn-statusMagento-ordretilstandMagento-ordrestatus
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

Modulet registrerer et webhook-endpoint på /nopayn/payment/webhook. Denne URL sendes automatisk til NoPayn ved oprettelse af ordrer. Webhooken verificerer altid ordrestatus via NoPayn API'et, inden Magento-ordren opdateres.

Ingen manuel webhook-konfiguration er nødvendig — modulet håndterer registrering automatisk.

4. Test din opsætning

  1. Foretag et par testtransaktioner — både vellykkede og fejlede
  2. Verificer, at alle aktiverede betalingsmetoder vises ved checkout
  3. Konfigurer hævningsadfærd (automatisk hævning vs. manuel) baseret på din leveringsproces

Support

Brug for hjælp? Kontakt vores supportteam på support@costplus.io.

On this page