Cost+Docs

PrestaShop

Integrer Cost+ med din PrestaShop-butikk (9.x, 8.x, 1.7 og 1.6)

PrestaShop

Integrer Cost+ som en betalingsmetode i din PrestaShop-butikk. Cost+-modulen er tilgjengelig for PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 og PrestaShop 1.6.1.x.

Forutsetninger

  • Aktiv Cost+ forhandlerkonto
  • PrestaShop 9.1 eller nyere
  • PHP 8.1 eller nyere
  • SSL/HTTPS aktivert
  • Administratortilgang til PrestaShop-administrasjonspanelet
  • Aktiv Cost+ forhandlerkonto
  • PrestaShop 8.x-installasjon
  • PHP 8.0 eller nyere
  • Administratortilgang til PrestaShop-administrasjonspanelet
  • MySQL 5.4 eller høyere
  • Aktiv Cost+ forhandlerkonto
  • PrestaShop 1.7.x-installasjon
  • PHP 5.4 eller nyere
  • Administratortilgang til PrestaShop-administrasjonspanelet
  • MySQL 5.4 eller høyere
  • Aktiv Cost+ forhandlerkonto
  • PrestaShop 1.6.1.x-installasjon
  • PHP 5.6 eller nyere (med cURL- og OpenSSL-utvidelser)
  • SSL/HTTPS aktivert på butikkfronten
  • Administratortilgang til PrestaShop-administrasjonspanelet

1. Installer modulen

Last ned modulen fra GitHub.

Metode A: Last opp via administrasjonspanelet (anbefalt)

  1. Gå til Moduler → Modulbehandler i administrasjonspanelet
  2. Klikk Last opp en modul
  3. Dra og slipp ZIP-filen eller velg den manuelt
  4. Vent til installasjonen er ferdig
  5. Søk etter «NoPayn» og klikk Konfigurer

Metode B: Manuell opplasting

  1. Kopier nopaynpayment/-mappen til PrestaShops modules/-katalog
  2. Gå til Moduler → Modulbehandler
  3. Søk etter «NoPayn» og klikk Installer
  4. Klikk Konfigurer for å åpne innstillingene

Last ned modulen fra GitHub.

Metode A: Last opp via administrasjonspanelet (anbefalt)

  1. Gå til Forbedre > Modulbehandler i administrasjonspanelet
  2. Klikk Last opp en modul
  3. Dra og slipp ZIP-filen eller velg den manuelt
  4. Vent til installasjonen er ferdig
  5. Bla ned til «Annet»-seksjonen og klikk Konfigurer under Cost+

PrestaShop 8 Modulbehandler

Last opp en modul-dialog

Metode B: Manuell opplasting via (S)FTP

  1. Pakk ut den nedlastede ZIP-filen
  2. Bruk en SFTP-klient (f.eks. FileZilla, WinSCP), last opp alle mapper til /modules/-katalogen i PrestaShop-installasjonen
  3. Gå til Forbedre > Moduler > Modulkatalog
  4. Søk etter «Cost+» -- sjekk Avinstallerte moduler-fanen om nødvendig
  5. Klikk Installer

Last ned modulen fra GitHub.

Metode A: Last opp via administrasjonspanelet (anbefalt)

  1. Gå til Forbedre > Modulbehandler i administrasjonspanelet
  2. Klikk Last opp en modul
  3. Dra og slipp ZIP-filen eller velg den manuelt
  4. Vent til installasjonen er ferdig
  5. Bla ned til «Annet»-seksjonen og klikk Konfigurer under Cost+

PrestaShop 1.7 Modulbehandler

Last opp en modul-dialog

Metode B: Manuell opplasting via (S)FTP

  1. Pakk ut den nedlastede ZIP-filen
  2. Bruk en SFTP-klient (f.eks. FileZilla, WinSCP), last opp alle mapper til /modules/-katalogen i PrestaShop-installasjonen
  3. Gå til Moduler > Modulbehandler
  4. Søk etter «Cost+» -- sjekk Avinstallerte moduler-fanen om nødvendig
  5. Klikk Installer

Last ned modulen fra GitHub.

Metode A: Last opp via administrasjonspanelet (anbefalt)

  1. Last ned costpluspayment.zip fra GitHub Releases-siden
  2. Gå til Modules and Services i PrestaShop-administrasjonspanelet
  3. Klikk Add a new module
  4. Last opp ZIP-filen
  5. Finn Cost+ Payment Gateway i modullisten og klikk Install

Metode B: Manuell opplasting via (S)FTP

  1. Pakk ut den nedlastede ZIP-filen
  2. Bruk en SFTP-klient og last opp mappen costpluspayment/ til /modules/costpluspayment/ i PrestaShop-installasjonen
  3. Gå til Modules and Services i administrasjonspanelet
  4. Finn Cost+ Payment Gateway og klikk Install

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

I NoPayn-modulkonfigurasjonen, skriv inn din API-nøkkel og konfigurer følgende innstillinger:

InnstillingBeskrivelse
API KeyDin NoPayn API-nøkkel
Credit / Debit CardAktiver/deaktiver kredittkortbetalinger
Apple PayAktiver/deaktiver Apple Pay
Google PayAktiver/deaktiver Google Pay
Vipps MobilePayAktiver/deaktiver Vipps MobilePay
Manual CaptureAutoriser kredittkortbetalinger kun — innløs når du sender
Debug LoggingAktiver detaljert logging til var/logs/nopayn_debug.log

Lim inn nøkkelen i API Key-feltet på Cost+ Library-konfigurasjonssiden og klikk Lagre.

Cost+-konfigurasjonssiden i PrestaShop 8

Lim inn nøkkelen i API Key-feltet på Cost+ Library-konfigurasjonssiden og klikk Lagre.

Cost+-konfigurasjonssiden i PrestaShop 1.7

Etter installasjon, klikk Configure på Cost+ Payment Gateway-modulen og still inn følgende:

InnstillingBeskrivelse
API KeyDin Cost+ API-nøkkel fra forhandlerportalen
Credit / Debit CardAktiver/deaktiver kredittkortbetalinger
Apple PayAktiver/deaktiver Apple Pay
Google PayAktiver/deaktiver Google Pay
Vipps MobilePayAktiver/deaktiver Vipps MobilePay
Manual CaptureAutoriser kredittkortbetalinger kun — innløs når du sender
Checkout ExpiryTimeout for ventende ordre i minutter (standard 5)
Debug LoggingAktiver detaljert logging til log/costplus_debug.log

Etter at du har lagret, åpne Payment > Restrictions og aktiver Cost+ Payment Gateway-modulen for hver valuta du aksepterer.

For PrestaShop 8.x, 1.7 og 1.6 hostingmiljøer, aktiver cURL CA bundle-alternativet under konfigurasjon for å unngå SSL-sertifikatproblemer.

3. Aktiver betalingsmetoder

Betalingsmetoder konfigureres direkte i modulinnstillingene (se steg 2 ovenfor). Slå hver metode av eller på etter behov.

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

Etter at du har lagret API-nøkkelen, last opp hver betalingsmetodemodul separat via Last opp en modul.

Gå tilbake til Forbedre > Modulbehandler, klikk Last opp en modul igjen, og last opp hver ZIP-fil for betalingsmetodene du vil aktivere (f.eks. kredittkort, MobilePay, Swish).

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

Betalingsmoduler vil enten ha et Konfigurer-alternativ (hvis ekstra oppsett er nødvendig) eller bare en Aktiver/Deaktiver-bryter.

Etter at du har lagret API-nøkkelen, last opp hver betalingsmetodemodul separat via Last opp en modul.

Gå tilbake til Forbedre > Modulbehandler, klikk Last opp en modul igjen, og last opp hver ZIP-fil for betalingsmetodene du vil aktivere (f.eks. kredittkort, MobilePay, Swish).

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

Betalingsmoduler vil enten ha et Konfigurer-alternativ (hvis ekstra oppsett er nødvendig) eller bare en Aktiver/Deaktiver-bryter.

Betalingsmetoder slås av/på direkte på modulkonfigurasjonssiden (se steg 2 ovenfor). Aktiver hver metode du vil ha tilgjengelig i utsjekkingen.

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

Betalingsflyt

  1. Kunden velger en Cost+-betalingsmetode i utsjekkingen
  2. Kunden videresendes til Cost+ sin hostede betalingsside (HPP)
  3. Etter fullført betaling videresendes kunden tilbake til butikken
  4. En webhook bekrefter betalingsstatusen server-til-server

Webhook

Webhook-URL-en konfigureres automatisk per ordre:

https://your-shop.com/module/nopaynpayment/webhook

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

Manuell innløsning

Når aktivert for kredittkortbetalinger:

  • Betalingen autoriseres men innløses ikke ved utsjekking
  • Innløsning skjer når ordren sendes / merkes som fullført
  • Hvis ordren avbrytes, annulleres autorisasjonen automatisk

Automatisk refusjon

Hvis en innløst betalingsordre avbrytes, utsteder modulen automatisk en full refusjon. Delvise refusjoner kan behandles via PrestaShops kreditnotaer.

Knappetekster i utsjekkingen

For den beste brukeropplevelsen med videresending til ekstern betalingsside, vurder å oppdatere utsjekkingens knappetekst til «Se over ordren» i stedet for «Bekreft og betal», siden selve betalingen skjer på Cost+ sin hostede side. Dette er en global PrestaShop-innstilling, ikke modulspesifikk.

Webhook

Webhooken konfigureres automatisk av modulen. Ingen manuelt oppsett er nødvendig.

Webhook

Webhooken konfigureres automatisk av modulen. Ingen manuelt oppsett er nødvendig.

Webhook

Modulkonfigurasjonssiden viser en webhook-URL. Kopier den inn i Cost+-dashbordet ditt hvis Cost+-kontoen din krever en statisk webhook-registrering.

Webhook-endepunktet mottar Cost+-hendelser og kaller deretter Cost+ på nytt med GET /orders/{id} før PrestaShop-ordren oppdateres — dette holder håndteringen av return-URL og webhook idempotent.

Expiry Cron

Modulkonfigurasjonssiden viser en expiry-cron-URL. Planlegg at den kjører hvert minutt:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Bruk den eksakte URL-en som vises i PrestaShop back office — tokenet genereres under installasjonen og er forskjellig for hver butikk. Cron-endepunktet kansellerer utdaterte ventende Cost+-ordre etter den konfigurerte Checkout Expiry.

Manuell innløsning og refusjoner

  • Med Manual Capture aktivert blir betalinger autorisert ved utsjekking og innløst når ordren sendes/merkes som fullført
  • Hvis en innløst ordre avbrytes, utsteder modulen automatisk en full refusjon
  • Delvise refusjoner behandles via PrestaShops kreditnotaer

4. Siste steg og testing

  1. Dobbeltsjekk alle aktiverte betalingsmetoder
  2. Gjennomfør noen testtransaksjoner -- både vellykkede og mislykkede -- for å sikre at alt fungerer som det skal
  3. Konfigurer avansert oppførsel som manuell kontra automatisk innløsning avhengig av leveringsprosessen din

Kundestøtte

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

On this page