Drupal Commerce

Integrer Cost+ med din Drupal Commerce-butik ved hjælp af det officielle betalingsgateway-modul

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

Forudsætninger

Aktiv Cost+-forhandlerkonto
Drupal 10 eller 11
Drupal Commerce 3.x
PHP 8.1 eller nyere
Administratoradgang til dit Drupal-site

Understøttede betalingsmetoder

Credit / Debit Card — Visa, Mastercard og flere
Apple Pay
Google Pay
Vipps / MobilePay

1. Installer modulet

Kopier modulet commerce_nopayn ind i din Drupal-installation og aktiver det:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

Du kan også downloade modulet direkte fra GitHub-repositoriet.

2. Tilføj en betalingsgateway

Naviger til Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
Klik Add payment gateway
Vælg NoPayn Payment Gateway som plugin

3. Konfigurer gatewayen

Indtast følgende indstillinger:

NoPayn API Key — Din forhandler-API-nøgle fra forhandlerportalen
Payment Methods — Aktiver eller deaktiver Credit Card, Apple Pay, Google Pay, Vipps MobilePay
Mode — Sæt til Test når du bruger en API-nøgle fra et sandbox-website, eller Live når du bruger en produktions-website-nøgle

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

Valgfrie indstillinger

Manual Capture — Autoriser kreditkortbetalinger uden øjeblikkelig hævning (midler reserveres, hæves derefter når ordren opfyldes)
Debug Logging — Aktiver for at logge alle API-anmodninger og -svar til Drupal-loggen til fejlsøgning

Klik Save når du er færdig.

4. Betalingsflow

Når konfigureret fungerer betalingsflowet som følger:

Kunden tilføjer produkter til kurven og fortsætter til checkout
Ved betalingstrinnet vises aktiverede Cost+-metoder som radioknapper
Kunden vælger en metode og bekræfter ordren
Modulet opretter en ordre via Cost+ API'et og omdirigerer til den hostede betalingsside
Kunden gennemfører betaling på Cost+-siden
Kunden vender tilbage til butikken — betaling verificeres via API
En webhook fra Cost+ bekræfter betalingsresultatet asynkront

Betalingssessioner udløber efter 5 minutter per Cost+-standarder. Modulet sender også detaljerede ordrelinjer (produkter og forsendelse) til Cost+ for detaljerede transaktionsposter.

5. Webhook-konfiguration

Webhook-URL'en genereres automatisk af Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

For eksempel: https://your-store.com/payment/notify/nopayn

Denne URL skal være tilgængelig fra internettet uden autentificering. Modulet verificerer altid betalingsstatus via API'et — det stoler aldrig på webhook-payloaden alene.

Manuel hævning

Når manuel hævning er aktiveret for kreditkort:

Kundens kort autoriseres (midler reserveres) under checkout
Hævning sker automatisk, når ordren skifter til Fulfilled
Hvis ordren annulleres, annulleres autorisationen via webhook

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.

Refusioner

Refusioner kan behandles direkte fra Commerce-adminpanelet. Både fulde og delvise refusioner understøttes.

Databasetabeller

Modulet opretter to tabeller til sporing:

Tabel	Formål
`nopayn_transactions`	Sporer betalingsordrer oprettet med Cost+ API'et
`nopayn_refunds`	Registrerer refusionsoperationer til revisionsformål

Afinstallation

drush pmu commerce_nopayn -y
drush cr

Afinstallation af modulet vil slette tabellerne 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. Sæt gatewayens Mode til Test og verificer både vellykkede og fejlede betalinger, inden du skifter til Live.

Support

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

On this page