DocsosCommerce
Integrer Cost+ med din osCommerce 4-butikk ved hjelp av den offisielle betalingsmodulen
Integrer Cost+ som en betalingsmetode i din osCommerce 4-butikk. Den offisielle NoPayn Payments-modulen bruker flyten med hostet betalingsside, så ingen kortdata berører serveren din — fullt PCI DSS-kompatibelt.
Forutsetninger
- Aktiv Cost+ forhandlerkonto
- osCommerce 4.x
- PHP 8.1 eller nyere
- cURL-utvidelse aktivert
- SSL-sertifikat (HTTPS påkrevd)
- Administratortilgang til osCommerce-administrasjonspanelet
Støttede betalingsmetoder
| Utsjekketikett | NoPayn-identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Hver metode kan individuelt aktiveres eller deaktiveres fra administrasjonspanelet.
1. Installer modulen
Last ned eller klon modulen fra GitHub.
Kopier lib/-katalogen til din osCommerce 4-rot:
cp -r lib/ /path/to/oscommerce/Dette plasserer modulfilene på:
lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.phpI osCommerce-administrasjonspanelet:
- Naviger til Moduler → Betaling → Online
- Aktiver «Vis inaktive» og «Vis ikke-installerte»-filtre om nødvendig
- Finn NoPayn Payments og klikk Installer
2. Konfigurer modulen
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.
Skriv inn din API-nøkkel og konfigurer følgende innstillinger:
| Innstilling | Beskrivelse | Standard |
|---|---|---|
| Enable NoPayn Payments | Hovedbryter for aktivering/deaktivering | True |
| API Key | Din NoPayn API-nøkkel | — |
| Enable Credit / Debit Card | Vis kreditt-/debetkort i utsjekkingen | True |
| Enable Apple Pay | Vis Apple Pay i utsjekkingen | True |
| Enable Google Pay | Vis Google Pay i utsjekkingen | True |
| Enable Vipps MobilePay | Vis Vipps MobilePay i utsjekkingen | True |
| Manual Capture (Credit Card) | Kun autoriser — innløs når ordren er fullført | False |
| Debug Logging | Skriv API-forespørsler/-svar til logg | False |
| Completed Order Status | Status satt når betaling lykkes | Processing |
| Pending Order Status | Status satt mens betaling avventes | Pending |
| Cancelled Order Status | Status satt ved kansellering/feil/utløp | Cancelled |
| Payment Zone | Begrens til en geografisk sone (valgfritt) | Alle soner |
| Sort Order | Visningsrekkefølge på utsjekkingssiden | 0 |
Aktiver kun betalingsmetodene du har blitt godkjent for og mottatt bekreftelse på.
3. Oppdater utsjekketiketter (anbefalt)
Standard osCommerce-utsjekk-knappetekster forutsetter en ett-trinns flyt. For en bedre opplevelse med videresending til ekstern betalingsside, oppdater disse oversettelsene i Admin → Lokalisering → Språk → Norsk → Definer:
| Nøkkel | Standard | Anbefalt |
|---|---|---|
TEXT_PAY_WITH_CARD | Betal med kort | Gå til betaling |
TEXT_CONFIRM_AND_PAY | Bekreft og betal | Se over ordren |
CONFIRM_ORDER | Bekreft ordre | Bekreft og betal |
Dette forbedrer kundeopplevelsen ved å gjøre utsjekkingsflyten tydeligere — kundene forstår at de vil bli videresendt for å fullføre betalingen på en sikker side.
4. Betalingsflyt
Når den er konfigurert, fungerer betalingsflyten som følger:
- Kunden velger en Cost+-betalingsmetode i utsjekkingen
- Kunden bekrefter ordren
- Modulen oppretter en ventende ordre og kaller Cost+ API-et
- Kunden videresendes til Cost+ sin hostede betalingsside (HPP)
- Kunden gjennomfører betalingen på den sikre HPP-en
- Kunden videresendes tilbake til butikken
- Modulen verifiserer betalingsstatus via Cost+ API-et
- Ordrestatusen oppdateres deretter
Betalingslenker utløper etter 5 minutter. Hvis kunden ikke fullfører betalingen innen dette vinduet, markeres ordren automatisk som kansellert.
5. Webhooks
Modulen registrerer en webhook-URL hos Cost+ for server-til-server statusoppdateringer. Når en betalingsstatus endres, sender Cost+ en varsling og modulen:
- Mottar webhook-POST-en
- Verifiserer betalingsstatus via API (stoler aldri på webhook-innholdet)
- Oppdaterer ordrestatusen i osCommerce
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
- Midler innløses når ordren går til fullført-status
- Hvis ordren kanselleres, annulleres autorisasjonen automatisk
Bruk manuell innløsning hvis du kun vil belaste kunder når ordren sendes. Dette er nyttig for forhandlere med lengre leveringstider.
Feilsøkingslogging
Når Debug Logging er aktivert, skriver modulen til nopayn_debug.log i osCommerce-loggkatalogen. Loggoppføringer inkluderer:
- Alle API-forespørsler og -svar
- Webhook-hendelser og behandlingsresultater
- Innløsnings- og annulleringsoperasjoner
- Feil (logges alltid, uavhengig av feilsøkingsbryteren)
Alle oppføringer har prefikset NoPayn_ for enkel filtrering.
Avinstallering
- Gå til Moduler → Betaling → Online i administrasjonspanelet
- Velg NoPayn Payments
- Klikk Fjern
Avinstallering av modulen fjerner konfigurasjonen og sletter databasetabellene nopayn_transactions og nopayn_refunds. Sørg for å eksportere eventuelle data du trenger før avinstallering.
Test og lanser
Gjennomfør noen testtransaksjoner for å sikre at alt fungerer som det skal. Vi anbefaler å teste både vellykkede og mislykkede betalinger for å bekrefte at alle scenarioer håndteres korrekt.
Kundestøtte
Trenger du hjelp? Kontakt kundestøtteteamet vårt på support@costplus.io.