Drupal Commerce

Integreer Cost+ met uw Drupal Commerce-winkel via de officiele betaalgateway-module

Integreer Cost+ als betaalmethode in uw Drupal Commerce-winkel. De officiele NoPayn Payment Gateway-module gebruikt de Hosted Payment Page-flow, zodat er geen kaartgegevens uw server bereiken — volledig PCI DSS-conform.

Vereisten

Actief Cost+ handelaarsaccount
Drupal 10 of 11
Drupal Commerce 3.x
PHP 8.1 of hoger
Beheerderstoegang tot uw Drupal-site

Ondersteunde betaalmethoden

Credit-/betaalkaart — Visa, Mastercard en meer
Apple Pay
Google Pay
Vipps / MobilePay

1. De module installeren

Kopieer de commerce_nopayn-module naar uw Drupal-installatie en schakel deze in:

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

U kunt de module ook rechtstreeks downloaden van de GitHub-repository.

2. Een betaalgateway toevoegen

Navigeer naar Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
Klik op Add payment gateway
Selecteer NoPayn Payment Gateway als plugin

3. De gateway configureren

Voer de volgende instellingen in:

NoPayn API Key — Uw API-sleutel voor handelaren uit het handelaarsportaal
Payment Methods — Schakel Credit Card, Apple Pay, Google Pay, Vipps MobilePay in of uit
Mode — Stel in op Test bij gebruik van een API-sleutel van een sandbox-website, of Live bij gebruik van een productiesleutel

Activeer alleen de betaalmethoden waarvoor u bent goedgekeurd en een bevestiging heeft ontvangen.

Optionele instellingen

Manual Capture — Autoriseer creditcardbetalingen zonder onmiddellijke capture (fondsen worden gereserveerd en gecaptured wanneer de bestelling wordt verwerkt)
Debug Logging — Schakel in om alle API-verzoeken en -respons te loggen naar het Drupal-logboek voor probleemoplossing

Klik op Save wanneer u klaar bent.

4. Betalingsflow

Na configuratie werkt de betalingsflow als volgt:

Klant voegt producten toe aan winkelwagen en gaat naar de kassa
Bij de betalingsstap worden de ingeschakelde Cost+-methoden getoond als keuzerondjes
Klant selecteert een methode en bevestigt de bestelling
De module maakt een bestelling aan via de Cost+ API en verwijst door naar de hosted payment page
Klant voltooit de betaling op de Cost+-pagina
Klant keert terug naar de winkel — betaling wordt geverifieerd via de API
Een webhook van Cost+ bevestigt asynchroon het betalingsresultaat

Betalingssessies verlopen na 5 minuten volgens Cost+-standaarden. De module stuurt ook gespecificeerde orderregels (producten en verzending) naar Cost+ voor gedetailleerde transactieoverzichten.

5. Webhookconfiguratie

De webhook-URL wordt automatisch gegenereerd door Drupal Commerce:

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

Bijvoorbeeld: https://your-store.com/payment/notify/nopayn

Deze URL moet toegankelijk zijn vanaf het internet zonder authenticatie. De module verifieert altijd de betalingsstatus via de API — de webhook-payload wordt nooit alleen vertrouwd.

Handmatige capture

Wanneer handmatige capture is ingeschakeld voor creditcards:

De kaart van de klant wordt geautoriseerd (fondsen gereserveerd) tijdens het afrekenen
Capture vindt automatisch plaats wanneer de bestelling overgaat naar Fulfilled
Als de bestelling wordt geannuleerd, wordt de autorisatie gevoided via webhook

Gebruik handmatige capture als u klanten pas wilt belasten wanneer hun bestelling wordt verzonden. Dit is handig voor handelaren met langere verwerkingstijden.

Terugbetalingen

Terugbetalingen kunnen rechtstreeks worden verwerkt vanuit het Commerce-beheerpaneel. Zowel volledige als gedeeltelijke terugbetalingen worden ondersteund.

Databasetabellen

De module maakt twee tabellen aan voor tracking:

Tabel	Doel
`nopayn_transactions`	Volgt betalingsbestellingen die zijn aangemaakt via de Cost+ API
`nopayn_refunds`	Registreert terugbetalingsoperaties voor auditdoeleinden

De-installatie

drush pmu commerce_nopayn -y
drush cr

Het de-installeren van de module verwijdert de tabellen nopayn_transactions en nopayn_refunds. Zorg ervoor dat u alle benodigde gegevens exporteert voordat u de module de-installeert.

Testen en live gaan

Doe een paar testtransacties om te controleren of alles soepel werkt. Stel de gateway Mode in op Test en verifieer zowel geslaagde als mislukte betalingen voordat u overschakelt naar Live.

Ondersteuning

Hulp nodig? Neem contact op met ons supportteam via support@costplus.io.

On this page