DocsOpenCart
Integreer Cost+ met uw OpenCart-winkel (4.x en 3.x / ocStore 3)
Integreer Cost+ als betaalmethode in uw OpenCart-winkel. De officiele NoPayn Payment Gateway-extensie is beschikbaar voor OpenCart 4 en OpenCart 3 / ocStore 3.
Vereisten
- Actief Cost+ handelaarsaccount
- OpenCart 4.0.0.0 of hoger
- PHP 8.0 of hoger
- Beheerderstoegang tot uw OpenCart-dashboard
- Actief Cost+ handelaarsaccount
- ocStore 3.0.x of OpenCart 3.0.3.x
- PHP 7.4 of hoger
- Beheerderstoegang tot uw OpenCart-dashboard
Ondersteunde betaalmethoden
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. De extensie installeren
Methode A: Uploaden via beheerpaneel (aanbevolen)
- Download de nieuwste
.ocmod.zip-release van GitHub - Ga in uw OpenCart-beheer naar Extensions → Installer
- Upload het
.ocmod.zip-bestand - Ga naar Extensions → Extensions → Payment
- Zoek NoPayn Payment Gateway en klik op Install en vervolgens Edit
Methode B: Handmatig uploaden
- Download of kloon de repository
- Kopieer de inhoud van de
upload/-map naar uw OpenCart-hoofdmap - Ga naar Extensions → Extensions → Payment
- Zoek NoPayn Payment Gateway en klik op Install en vervolgens Edit
Architectuur
OpenCart 3 gebruikt een multi-extensie-opzet:
- NoPayn - Global Settings — gedeelde configuratie (API-sleutel, bestellingsstatussen, beschikbaarheid van methoden, handmatige capture, foutopsporingslogboek)
- NoPayn - Card Payments — credit-/betaalkaart bij afrekenen
- NoPayn - Apple Pay / Google Pay — wallet-afrekenen (als slechts een wallet is ingeschakeld, past het label zich automatisch aan)
- NoPayn - Vipps MobilePay — Vipps/MobilePay-afrekenen
- NoPayn - Swish — Swish-afrekenen
Methode A: Uploaden via beheerpaneel (aanbevolen)
- Download het
.ocmod.zip-bestand van de nieuwste GitHub-release
Gebruik het .ocmod.zip-bestand van de release — niet de automatisch gegenereerde "Source code"-downloads van GitHub, die de repository-indeling bevatten en niet de installatieindeling.
- Ga in het beheer naar Extensions → Installer
- Upload het
.ocmod.zip-bestand - Ga naar Extensions → Extensions → Payments
- Installeer eerst NoPayn - Global Settings
- Open NoPayn - Global Settings en configureer:
- API-sleutel
- Bestellingsstatussen voor voltooid, in behandeling en geannuleerd
- Beschikbare betaalmethoden waarvoor uw handelaarsaccount is goedgekeurd
- Optioneel: handmatige capture voor kaarten
- Optioneel: foutopsporingslogboek
- Installeer de afrekenmodules die u wilt tonen:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Stel voor elke afrekenmodule in: Status, Geo Zone en Sort Order
Methode B: Handmatig uploaden
- Download of kloon de repository
- Kopieer de inhoud van de
upload/-map naar uw winkelhoofmap - Ga naar Extensions → Extensions → Payments
- Volg dezelfde installatievolgorde als Methode A (eerst Global Settings, daarna afrekenmodules)
2. API-gegevens invoeren
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 in de NoPayn Payment Gateway-instellingen uw API Key in het bijbehorende veld in.
Voer in NoPayn - Global Settings uw API Key in het bijbehorende veld in. De API-sleutel wordt gedeeld door alle afrekenmodules — u hoeft deze slechts eenmaal in te voeren.
3. Betalingsinstellingen configureren
- Schakel de betaalmethoden in waarvoor u bent goedgekeurd
- Stel uw gewenste bestellingsstatussen in voor voltooide, in behandeling zijnde en geannuleerde betalingen
- Beperk betalingen optioneel per Geo Zone
- Stel Status in op Enabled
- Klik op Save
Globale instellingen
NoPayn - Global Settings bevat alle gedeelde configuratie:
| Instelling | Beschrijving |
|---|---|
| API Key | Uw NoPayn API-sleutel |
| Order Statuses | Statusmapping voor voltooid, in behandeling en geannuleerd |
| Method Availability | Welke betaalmethoden uw handelaarsaccount mag gebruiken |
| Manual Capture | Creditcardbetalingen alleen autoriseren — later capturen |
| Debug Logging | Gedetailleerd logboek inschakelen voor probleemoplossing |
Afrekenmodule-instellingen
Elke afrekenmodule heeft eigen winkelinstellingen:
| Instelling | Beschrijving |
|---|---|
| Status | Deze betaalmethode bij afrekenen in- of uitschakelen |
| Geo Zone | Beperken tot specifieke geografische zones |
| Sort Order | Weergavevolgorde op de afrekenpagina |
Activeer alleen de betaalmethoden waarvoor u bent goedgekeurd en een bevestiging heeft ontvangen.
Betalingsflow
- Klant selecteert een Cost+-betaalmethode bij het afrekenen
- Klant wordt doorverwezen naar de NoPayn Hosted Payment Page
- Na betaling keert de klant terug en wordt de bestellingsstatus automatisch bijgewerkt
- NoPayn stuurt een webhook voor asynchrone statusbevestiging
De extensie gebruikt de Cost+ Hosted Payment Page, wat betekent dat klanten worden doorverwezen naar een beveiligd betalingsformulier. Er worden geen gevoelige kaartgegevens door uw server verwerkt.
Elke afrekenmodule is een afzonderlijke OpenCart-betalingsextensie, waardoor klanten aparte keuzerondjes krijgen bij het afrekenen (bijv. "Card Payments", "Apple Pay & Google Pay").
- Klant selecteert een betaalmethodelabel bij het afrekenen (bijv. Card Payments)
- De extensie maakt een NoPayn hosted payment-bestelling aan
- Klant wordt doorverwezen naar de beveiligde NoPayn-betaalpagina
- Na betaling keert de klant terug en wordt de bestellingsstatus automatisch bijgewerkt
- NoPayn stuurt een webhook voor asynchrone statusbevestiging
De Apple Pay / Google Pay-module stuurt beide methoden in een transactie, zodat de NoPayn-gehoste pagina beide walletopties in een enkele flow kan aanbieden.
Upgraden van v1.0.0 naar v2.0.0
Versie 1.0.0 gebruikte een enkele afrekenmethode genaamd "NoPayn Checkout". Versie 2.0.0 verandert naar afzonderlijke afrekenmodules per betaalmethode. Bij het upgraden:
- Upload het nieuwe pakket
- Uw bestaande "NoPayn Checkout"-vermelding wordt NoPayn - Global Settings
- Controleer en sla de globale instellingen op
- Installeer en schakel de nieuwe afrekenmodules in die u aan klanten wilt tonen
4. 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.