Cost+Docs

Magento

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

Magento

Integrera Cost+ som betalningsmetod i din Magento-butik. Cost+-tillägget finns tillgängligt för Magento 2 (2.4.6 – 2.4.8) och Magento 1.9 (inklusive OpenMage LTS 20+).

Förutsättningar

  • Aktivt Cost+-handelskonto
  • Magento 2.4.6 – 2.4.8-installation
  • PHP 8.2 – 8.4
  • Administratörsåtkomst till din Magento-adminpanel
  • SSH-åtkomst till din server (för Composer-installation)
  • Aktivt Cost+-handelskonto
  • Magento 1.9.x eller OpenMage LTS 20+
  • PHP 7.4 eller senare
  • Administratörsåtkomst till din Magento-adminpanel
  • SSH- eller FTP-åtkomst till din server

1. Installera tillägget

Metod A: Installation via Composer (rekommenderat)

Anslut till din Magento-server via SSH och navigera till din Magento-rotkatalog.

Installera pluginet:

composer require nopayn/nopayn-magento-2

Kör Magento setup-kommandon:

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

Om du är i produktionsläge, kör även:

php bin/magento setup:static-content:deploy

Metod B: Manuell installation

  1. Navigera till din app/code-katalog
  2. Ladda ner och packa upp Cost+-versionen från GitHub
  3. Kör setup-kommandona:
php bin/magento setup:upgrade
php bin/magento cache:clean

Om i produktionsläge:

php bin/magento setup:static-content:deploy

Ladda ner eller klona modulen från GitHub.

Kopiera innehållet i app/ till din Magento-rot app/-katalog:

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

Rensa Magento-cachen:

rm -rf var/cache/*

Logga in på Magento-adminpanelen och navigera till System → Konfiguration → Försäljning → Betalningsmetoder för att verifiera att sektionen NoPayn Payment Gateway visas.

Modulen skapar en nopayn_transactions-tabell i din databas för att spåra betalningstransaktioner. Denna skapas automatiskt vid första användning.

2. Konfigurera pluginet

  1. Gå till Butiker → Konfiguration → Försäljning → Betalningsmetoder → Cost+ Payments
  2. Ange din API-nyckel (se steg 3 nedan)
  3. Aktivera de betalningsmetoder du har blivit godkänd för
  4. Spara ändringar
  1. Gå till System → Konfiguration → Försäljning → Betalningsmetoder
  2. Hitta sektionen NoPayn Payment Gateway
  3. Ange din API-nyckel (se steg 3 nedan)
  4. Aktivera individuella betalningsmetoder (kredit-/betalkort, Apple Pay, Google Pay, Vipps MobilePay)
  5. Valfritt begränsa per land
  6. Spara konfigurationen

3. Ange API-uppgifter

Logga in på handlarportalen och navigera till Webbplatser, klicka sedan på den webbplats du vill ansluta. Klicka på Integration där du hittar din API-nyckel.

Cost+ handlarportal som visar API-nyckel

Klistra in API-nyckeln i konfigurationsfältet och spara.

Aktivera bara de betalningsmetoder du har blivit godkänd för och fått bekräftelse på.

Betalningsmetoder som stöds

KassanamnNoPayn-identifierare
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Betalningsflöde

  1. Kunden väljer en betalningsmetod i kassan och lägger ordern
  2. Kunden omdirigeras till NoPayn Hosted Payment Page
  3. Efter betalning återvänder kunden och orderstatusen uppdateras automatiskt
  4. NoPayn skickar en webhook för asynkron statusbekräftelse
  1. Kunden väljer en betalningsmetod i kassan och lägger ordern
  2. Ordern skapas med status Inväntar betalning
  3. Kunden omdirigeras till NoPayns säkra betalningssida
  4. Efter betalning:
    • Lyckad — kunden återvänder, status verifieras via API, order sätts till Bearbetas
    • Avbruten — kunden återvänder, order sätts till Avbruten
    • Utgången (5-minuters timeout) — webhook utlöses, order sätts till Avbruten
  5. NoPayn skickar en webhook för asynkron statusbekräftelse

Orderstatusmappning

NoPayn-statusMagento orderlägeMagento orderstatus
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

Modulen registrerar en webhook-endpoint på /nopayn/payment/webhook. Denna URL skickas automatiskt till NoPayn vid orderskapande. Webhooken verifierar alltid orderstatus via NoPayn API:et innan Magento-ordern uppdateras.

Ingen manuell webhook-konfiguration krävs — modulen hanterar registreringen automatiskt.

4. Testa din konfiguration

  1. Gör några testtransaktioner — både lyckade och misslyckade
  2. Verifiera att alla aktiverade betalningsmetoder visas i kassan
  3. Konfigurera debiteringsbeteende (automatisk debitering kontra manuell) baserat på din leveransprocess

Support

Behöver du hjälp? Kontakta vårt supportteam på support@costplus.io.

On this page