Cost+Docs

Magento

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

Magento

Integrer Cost+ som en betalingsmetode i din Magento-butikk. Cost+-utvidelsen er tilgjengelig for Magento 2 (2.4.6 – 2.4.8) og Magento 1.9 (inkludert OpenMage LTS 20+).

Forutsetninger

  • Aktiv Cost+ forhandlerkonto
  • Magento 2.4.6 – 2.4.8-installasjon
  • PHP 8.2 – 8.4
  • Administratortilgang til Magento-administrasjonspanelet
  • SSH-tilgang til serveren din (for Composer-installasjon)
  • Aktiv Cost+ forhandlerkonto
  • Magento 1.9.x eller OpenMage LTS 20+
  • PHP 7.4 eller nyere
  • Administratortilgang til Magento-administrasjonspanelet
  • SSH- eller FTP-tilgang til serveren din

1. Installer utvidelsen

Metode A: Installasjon via Composer (anbefalt)

Koble til Magento-serveren din via SSH og naviger til Magento-rotkatalogen.

Installer tillegget:

composer require nopayn/nopayn-magento-2

Kjør Magento-oppsettkommandoer:

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

Hvis du er i produksjonsmodus, kjør også:

php bin/magento setup:static-content:deploy

Metode B: Manuell installasjon

  1. Naviger til app/code-katalogen
  2. Last ned og pakk ut Cost+-utgivelsen fra GitHub
  3. Kjør oppsettkommandoene:
php bin/magento setup:upgrade
php bin/magento cache:clean

Hvis i produksjonsmodus:

php bin/magento setup:static-content:deploy

Last ned eller klon modulen fra GitHub.

Kopier innholdet av app/ til din Magento-rot app/-katalog:

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

Tøm Magento-hurtigbufferen:

rm -rf var/cache/*

Logg inn på Magento-administrasjonspanelet og naviger til System → Konfigurasjon → Salg → Betalingsmetoder for å verifisere at NoPayn Payment Gateway-seksjonen vises.

Modulen oppretter en nopayn_transactions-tabell i databasen for å spore betalingstransaksjoner. Denne opprettes automatisk ved første bruk.

2. Konfigurer tillegget

  1. Gå til Butikker → Konfigurasjon → Salg → Betalingsmetoder → Cost+ Payments
  2. Skriv inn API-nøkkelen din (se steg 3 nedenfor)
  3. Aktiver betalingsmetodene du har blitt godkjent for
  4. Lagre endringer
  1. Gå til System → Konfigurasjon → Salg → Betalingsmetoder
  2. Finn NoPayn Payment Gateway-seksjonen
  3. Skriv inn API-nøkkelen din (se steg 3 nedenfor)
  4. Aktiver individuelle betalingsmetoder (Kreditt-/debetkort, Apple Pay, Google Pay, Vipps MobilePay)
  5. Begrens eventuelt per land
  6. Lagre konfigurasjonen

3. Skriv inn API-legitimasjon

Logg inn på forhandlerportalen og naviger til Nettsteder, klikk deretter på nettstedet du vil koble til. Klikk på Integrasjon der du finner API-nøkkelen din.

Cost+ forhandlerportal som viser API-nøkkel

Lim inn API-nøkkelen i konfigurasjonsfeltet og lagre.

Aktiver kun betalingsmetodene du har blitt godkjent for og mottatt bekreftelse på.

Støttede betalingsmetoder

Visningsnavn i utsjekkingNoPayn-identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Betalingsflyt

  1. Kunden velger en betalingsmetode i utsjekkingen og legger inn ordren
  2. Kunden videresendes til NoPayn sin hostede betalingsside
  3. Etter betaling returnerer kunden og ordrestatusen oppdateres automatisk
  4. NoPayn sender en webhook for asynkron statusbekreftelse
  1. Kunden velger en betalingsmetode i utsjekkingen og legger inn ordren
  2. Ordren opprettes med status Avventer betaling
  3. Kunden videresendes til NoPayn sin sikre betalingsside
  4. Etter betaling:
    • Vellykket — kunden returnerer, status verifiseres via API, ordren settes til Behandles
    • Avbrutt — kunden returnerer, ordren settes til Kansellert
    • Utløpt (5-minutters tidsgrense) — webhook utløses, ordren settes til Kansellert
  5. NoPayn sender en webhook for asynkron statusbekreftelse

Ordrestatuskartlegging

NoPayn-statusMagento ordretilstandMagento ordrestatus
newpending_paymentAvventer betaling
processingpending_paymentAvventer betaling
completedprocessingBehandles
cancelledcanceledKansellert
expiredcanceledKansellert
errorcanceledKansellert

Webhooks

Modulen registrerer et webhook-endepunkt på /nopayn/payment/webhook. Denne URL-en sendes automatisk til NoPayn ved oppretting av ordrer. Webhooken verifiserer alltid ordrestatusen via NoPayn API-et før den oppdaterer Magento-ordren.

Ingen manuell webhook-konfigurasjon er nødvendig — modulen håndterer registrering automatisk.

4. Test oppsettet ditt

  1. Gjennomfør noen testtransaksjoner — både vellykkede og mislykkede
  2. Verifiser at alle aktiverte betalingsmetoder vises i utsjekkingen
  3. Konfigurer innløsningsoppførsel (automatisk innløsning kontra manuell) basert på leveringsprosessen din

Kundestøtte

Trenger du hjelp? Kontakt kundestøtteteamet vårt på support@costplus.io.

On this page