DocsosCommerce
Integrera Cost+ med din osCommerce 4-butik via den officiella betalningsmodulen
Integrera Cost+ som betalningsmetod i din osCommerce 4-butik. Den officiella NoPayn Payments-modulen använder Hosted Payment Page-flödet, så ingen kortdata hanteras av din server — fullt PCI DSS-kompatibelt.
Förutsättningar
- Aktivt Cost+-handelskonto
- osCommerce 4.x
- PHP 8.1 eller senare
- cURL-tillägg aktiverat
- SSL-certifikat (HTTPS krävs)
- Administratörsåtkomst till din osCommerce-adminpanel
Betalningsmetoder som stöds
| Kassaetikett | NoPayn-identifierare |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Varje metod kan individuellt aktiveras eller inaktiveras från adminpanelen.
1. Installera modulen
Ladda ner eller klona modulen från GitHub.
Kopiera lib/-katalogen till din osCommerce 4-rot:
cp -r lib/ /path/to/oscommerce/Detta placerar modulfilerna 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 din osCommerce-adminpanel:
- Navigera till Moduler → Betalning → Online
- Aktivera filtren "Visa inaktiva" och "Visa inte installerade" om det behövs
- Hitta NoPayn Payments och klicka på Installera
2. Konfigurera modulen
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.
Ange din API-nyckel och konfigurera följande inställningar:
| Inställning | Beskrivning | Standard |
|---|---|---|
| Enable NoPayn Payments | Huvudomkopplare för aktivering/inaktivering | True |
| API Key | Din NoPayn API-nyckel | — |
| Enable Credit / Debit Card | Visa kredit-/betalkort i kassan | True |
| Enable Apple Pay | Visa Apple Pay i kassan | True |
| Enable Google Pay | Visa Google Pay i kassan | True |
| Enable Vipps MobilePay | Visa Vipps MobilePay i kassan | True |
| Manual Capture (Credit Card) | Auktorisera enbart — debitera när ordern slutförs | False |
| Debug Logging | Skriv API-förfrågningar/-svar till logg | False |
| Completed Order Status | Status som sätts vid lyckad betalning | Processing |
| Pending Order Status | Status som sätts vid väntande betalning | Pending |
| Cancelled Order Status | Status som sätts vid avbrytning/misslyckande/utgång | Cancelled |
| Payment Zone | Begränsa till en geografisk zon (valfritt) | Alla zoner |
| Sort Order | Visningsordning på kassasidan | 0 |
Aktivera bara de betalningsmetoder du har blivit godkänd för och fått bekräftelse på.
3. Uppdatera kassaetiketter (rekommenderat)
osCommerce standardkassaknappetiketter förutsätter ett enstegflöde. För en bättre upplevelse med omdirigering till extern betalningssida, uppdatera dessa översättningar i Admin → Lokalisering → Språk → Svenska → Definiera:
| Nyckel | Standard | Rekommenderat |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Gå till betalning |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Granska order |
CONFIRM_ORDER | Confirm order | Bekräfta och betala |
Detta förbättrar kundupplevelsen genom att göra kassaflödet tydligare — kunder förstår att de kommer omdirigeras för att slutföra betalningen på en säker sida.
4. Betalningsflöde
När modulen är konfigurerad fungerar betalningsflödet enligt följande:
- Kunden väljer en Cost+-betalningsmetod i kassan
- Kunden bekräftar ordern
- Modulen skapar en väntande order och anropar Cost+ API:et
- Kunden omdirigeras till Cost+ Hosted Payment Page (HPP)
- Kunden slutför betalningen på den säkra HPP-sidan
- Kunden omdirigeras tillbaka till butiken
- Modulen verifierar betalningsstatus via Cost+ API:et
- Orderstatus uppdateras i enlighet med resultatet
Betalningslänkar löper ut efter 5 minuter. Om kunden inte slutför betalningen inom denna tidsram markeras ordern automatiskt som avbruten.
5. Webhooks
Modulen registrerar en webhook-URL hos Cost+ för server-till-server-statusuppdateringar. När en betalningsstatus ändras skickar Cost+ en notifiering och modulen:
- Tar emot webhook-POST:en
- Verifierar betalningsstatus via API:et (litar aldrig på webhook-payloaden)
- Uppdaterar orderstatus i osCommerce
Ingen manuell webhook-konfiguration krävs — modulen hanterar registreringen automatiskt.
Manuell debitering
När aktiverad för kortbetalningar:
- Betalningen auktoriseras men debiteras inte i kassan
- Medel debiteras när ordern övergår till slutförd status
- Om ordern avbryts makuleras auktoriseringen automatiskt
Använd manuell debitering om du bara vill debitera kunder när deras order skickas. Detta är användbart för handlare med längre leveranstider.
Felsökningsloggning
När Debug Logging är aktiverat skriver modulen till nopayn_debug.log i osCommerce-loggkatalogen. Loggposter inkluderar:
- Alla API-förfrågningar och -svar
- Webhook-händelser och bearbetningsresultat
- Debiterings- och makuleringsoperationer
- Fel (loggas alltid, oavsett felsökningsinställning)
Alla poster har prefixet NoPayn_ för enkel filtrering.
Avinstallation
- Gå till Moduler → Betalning → Online i adminpanelen
- Välj NoPayn Payments
- Klicka på Ta bort
Avinstallation av modulen tar bort konfigurationen och raderar databastabellerna nopayn_transactions och nopayn_refunds. Se till att exportera eventuell data du behöver innan du avinstallerar.
Testa och lansera
Gör några testtransaktioner för att säkerställa att allt fungerar smidigt. Vi rekommenderar att testa både lyckade och misslyckade betalningar för att bekräfta att alla scenarier hanteras korrekt.
Support
Behöver du hjälp? Kontakta vårt supportteam på support@costplus.io.