DocsosCommerce
Integreer Cost+ met uw osCommerce 4-winkel via de officiele betalingsmodule
Integreer Cost+ als betaalmethode in uw osCommerce 4-winkel. De officiele NoPayn Payments-module gebruikt de Hosted Payment Page-flow, zodat er geen kaartgegevens uw server bereiken — volledig PCI DSS-conform.
Vereisten
- Actief Cost+ handelaarsaccount
- osCommerce 4.x
- PHP 8.1 of hoger
- cURL-extensie ingeschakeld
- SSL-certificaat (HTTPS vereist)
- Beheerderstoegang tot uw osCommerce-beheerpaneel
Ondersteunde betaalmethoden
| Kassalabel | NoPayn-identifier |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Elke methode kan individueel worden in- of uitgeschakeld vanuit het beheerpaneel.
1. De module installeren
Download of kloon de module van GitHub.
Kopieer de lib/-directory naar uw osCommerce 4-hoofdmap:
cp -r lib/ /path/to/oscommerce/Dit plaatst de modulebestanden op:
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.phpIn uw osCommerce-beheerpaneel:
- Navigeer naar Modules → Payment → Online
- Schakel de filters Show inactive en Show not installed in indien nodig
- Zoek NoPayn Payments en klik op Install
2. De module configureren
Log in op het handelaarsportaal en navigeer naar Websites, klik vervolgens op de website die u wilt verbinden. Klik op Integration waar u uw API-sleutel vindt.
Voer uw API Key in en configureer de volgende instellingen:
| Instelling | Beschrijving | Standaard |
|---|---|---|
| Enable NoPayn Payments | Hoofdschakelaar in-/uitschakelen | True |
| API Key | Uw NoPayn API-sleutel | — |
| Enable Credit / Debit Card | Credit-/betaalkaart tonen bij afrekenen | True |
| Enable Apple Pay | Apple Pay tonen bij afrekenen | True |
| Enable Google Pay | Google Pay tonen bij afrekenen | True |
| Enable Vipps MobilePay | Vipps MobilePay tonen bij afrekenen | True |
| Manual Capture (Credit Card) | Alleen autoriseren — capturen wanneer bestelling is voltooid | False |
| Debug Logging | API-verzoeken/respons naar logboek schrijven | False |
| Completed Order Status | Status bij geslaagde betaling | Processing |
| Pending Order Status | Status tijdens wachten op betaling | Pending |
| Cancelled Order Status | Status bij annulering/mislukking/verloop | Cancelled |
| Payment Zone | Beperken tot een geografische zone (optioneel) | Alle zones |
| Sort Order | Weergavevolgorde op de afrekenpagina | 0 |
Activeer alleen de betaalmethoden waarvoor u bent goedgekeurd en een bevestiging heeft ontvangen.
3. Kassalabels bijwerken (aanbevolen)
De standaard osCommerce-knoplabels bij het afrekenen gaan uit van een eenstapsflow. Voor een betere ervaring met de offsite-betalingsdoorverwijzing kunt u deze vertalingen bijwerken in Admin → Localisation → Languages → English → Define:
| Sleutel | Standaard | Aanbevolen |
|---|---|---|
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 |
Dit verbetert de klantervaring door de afrekenflow duidelijker te maken — klanten begrijpen dat ze worden doorverwezen om de betaling op een beveiligde pagina te voltooien.
4. Betalingsflow
Na configuratie werkt de betalingsflow als volgt:
- Klant selecteert een Cost+-betaalmethode bij het afrekenen
- Klant bevestigt de bestelling
- Module maakt een bestelling aan met status Pending en roept de Cost+ API aan
- Klant wordt doorverwezen naar de Cost+ Hosted Payment Page (HPP)
- Klant voltooit de betaling op de beveiligde HPP
- Klant wordt teruggeleid naar de winkel
- Module verifieert de betalingsstatus via de Cost+ API
- Bestellingsstatus wordt dienovereenkomstig bijgewerkt
Betaallinks verlopen na 5 minuten. Als de klant de betaling niet binnen dit tijdvenster voltooit, wordt de bestelling automatisch als geannuleerd gemarkeerd.
5. Webhooks
De module registreert een webhook-URL bij Cost+ voor server-to-server statusupdates. Wanneer een betalingsstatus verandert, stuurt Cost+ een melding en de module:
- Ontvangt de webhook-POST
- Verifieert de betalingsstatus via de API (vertrouwt nooit alleen op de webhook-payload)
- Werkt de bestellingsstatus bij in osCommerce
Handmatige webhookconfiguratie is niet nodig — de module handelt de registratie automatisch af.
Handmatige capture
Wanneer ingeschakeld voor creditcardbetalingen:
- Betaling wordt geautoriseerd maar niet gecaptured bij het afrekenen
- Fondsen worden gecaptured wanneer de bestelling overgaat naar status completed
- Als de bestelling wordt geannuleerd, wordt de autorisatie automatisch gevoided
Gebruik handmatige capture als u klanten pas wilt belasten wanneer hun bestelling wordt verzonden. Dit is handig voor handelaren met langere verwerkingstijden.
Foutopsporingslogboek
Wanneer Debug Logging is ingeschakeld, schrijft de module naar nopayn_debug.log in de osCommerce-logboekdirectory. Logvermeldingen bevatten:
- Alle API-verzoeken en -respons
- Webhook-gebeurtenissen en verwerkingsresultaten
- Capture- en void-operaties
- Fouten (worden altijd gelogd, ongeacht de debug-instelling)
Alle vermeldingen hebben het voorvoegsel NoPayn_ voor eenvoudig filteren.
De-installatie
- Ga naar Modules → Payment → Online in het beheerpaneel
- Selecteer NoPayn Payments
- Klik op Remove
Het de-installeren van de module verwijdert de configuratie en de databasetabellen 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. We raden aan om zowel geslaagde als mislukte betalingen te testen om te bevestigen dat alle scenario's correct worden afgehandeld.
Ondersteuning
Hulp nodig? Neem contact op met ons supportteam via support@costplus.io.