osCommerce

Integrer Cost+ med din osCommerce 4-butik ved hjælp af det officielle betalingsmodul

Integrer Cost+ som betalingsmetode i din osCommerce 4-butik. Det officielle NoPayn Payments-modul bruger Hosted Payment Page-flowet, så ingen kortdata rører din server — fuldt PCI DSS-kompatibelt.

Forudsætninger

Aktiv Cost+-forhandlerkonto
osCommerce 4.x
PHP 8.1 eller nyere
cURL-udvidelse aktiveret
SSL-certifikat (HTTPS påkrævet)
Administratoradgang til dit osCommerce-adminpanel

Understøttede betalingsmetoder

Checkout-etiket	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 adminpanelet.

1. Installer modulet

Download eller klon modulet fra GitHub.

Kopier lib/-biblioteket ind i dit osCommerce 4-rodbibliotek:

cp -r lib/ /path/to/oscommerce/

Dette placerer modulfilerne 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.php

I dit osCommerce-adminpanel:

Naviger til Modules → Payment → Online
Aktiver filtrene "Show inactive" og "Show not installed" hvis nødvendigt
Find NoPayn Payments og klik Install

2. Konfigurer modulet

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

Indtast din API-nøgle og konfigurer følgende indstillinger:

Indstilling	Beskrivelse	Standard
Enable NoPayn Payments	Overordnet aktiver/deaktiver-kontakt	True
API Key	Din NoPayn API-nøgle	—
Enable Credit / Debit Card	Vis kredit-/betalingskort ved checkout	True
Enable Apple Pay	Vis Apple Pay ved checkout	True
Enable Google Pay	Vis Google Pay ved checkout	True
Enable Vipps MobilePay	Vis Vipps MobilePay ved checkout	True
Manual Capture (Credit Card)	Autoriser kun — hæv når ordren fuldføres	False
Debug Logging	Skriv API-anmodninger/-svar til log	False
Completed Order Status	Status ved vellykket betaling	Processing
Pending Order Status	Status under afventning af betaling	Pending
Cancelled Order Status	Status ved annullering/fejl/udløb	Cancelled
Payment Zone	Begræns til en geografisk zone (valgfrit)	All zones
Sort Order	Visningsrækkefølge på checkout-siden	0

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

3. Opdater checkout-etiketter (anbefalet)

Standard osCommerce checkout-knapetiketter antager et enkelt-trins flow. For en bedre oplevelse med offsite betalingsomdirigeringen, opdater disse oversættelser i Admin → Localisation → Languages → English → Define:

Nøgle	Standard	Anbefalet
`TEXT_PAY_WITH_CARD`	Pay with card	Go to payment
`TEXT_CONFIRM_AND_PAY`	Confirm and pay	Review order
`CONFIRM_ORDER`	Confirm order	Confirm and pay

Dette forbedrer kundeoplevelsen ved at gøre checkout-flowet klarere — kunderne forstår, at de vil blive omdirigeret til at gennemføre betaling på en sikker side.

4. Betalingsflow

Når konfigureret fungerer betalingsflowet som følger:

Kunden vælger en Cost+-betalingsmetode ved checkout
Kunden bekræfter ordren
Modulet opretter en afventende ordre og kalder Cost+ API'et
Kunden omdirigeres til Cost+ Hosted Payment Page (HPP)
Kunden gennemfører betaling på den sikre HPP
Kunden omdirigeres tilbage til butikken
Modulet verificerer betalingsstatus via Cost+ API'et
Ordrestatus opdateres i overensstemmelse hermed

Betalingslinks udløber efter 5 minutter. Hvis kunden ikke gennemfører betaling inden for dette vindue, markeres ordren automatisk som annulleret.

5. Webhooks

Modulet registrerer en webhook-URL med Cost+ til server-til-server statusopdateringer. Når en betalingsstatus ændres, sender Cost+ en notifikation, og modulet:

Modtager webhook-POST'en
Verificerer betalingsstatus via API (stoler aldrig på webhook-payloaden)
Opdaterer ordrestatus i osCommerce

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

Manuel hævning

Når aktiveret for kreditkortbetalinger:

Betalingen autoriseres men hæves ikke ved checkout
Midler hæves, når ordren skifter til completed-status
Hvis ordren annulleres, annulleres autorisationen automatisk

Brug manuel hævning, hvis du kun vil opkræve kunder, når deres ordre sendes. Dette er nyttigt for forhandlere med længere leveringstider.

Fejlsøgningslogning

Når Debug Logging er aktiveret, skriver modulet til nopayn_debug.log i osCommerce-logbiblioteket. Logposter inkluderer:

Alle API-anmodninger og -svar
Webhook-hændelser og behandlingsresultater
Hævnings- og annulleringsoperationer
Fejl (logges altid, uanset fejlsøgningskontakt)

Alle poster er præfikset med NoPayn_ for nem filtrering.

Afinstallation

Gå til Modules → Payment → Online i adminpanelet
Vælg NoPayn Payments
Klik Remove

Afinstallation af modulet fjerner konfigurationen og sletter databasetabellerne nopayn_transactions og nopayn_refunds. Sørg for at eksportere data, du har brug for, inden afinstallation.

Test og lancering

Foretag et par testtransaktioner for at sikre, at alt fungerer problemfrit. Vi anbefaler at teste både vellykkede og fejlede betalinger for at bekræfte, at alle scenarier håndteres korrekt.

Support

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

On this page