Cost+Docs

Shopware

Integreer Cost+ met uw Shopware 6-winkel via de officiele betalingsplugin

Shopware

Integreer Cost+ als betaalmethode in uw Shopware 6-winkel. De officiele NoPayn Payment-plugin ondersteunt meerdere betaalmethoden per verkoopkanaal en gebruikt de Hosted Payment Page-flow — volledig PCI DSS-conform.

Vereisten

  • Actief Cost+ handelaarsaccount
  • Shopware 6.7 of hoger
  • PHP 8.2 of hoger
  • SSH- of terminaltoegang tot uw Shopware-server

Ondersteunde betaalmethoden

KassanaamTechnische naamNoPayn-identifier
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Elke methode kan per verkoopkanaal worden in- of uitgeschakeld vanuit de pluginconfiguratie.

1. De plugin installeren

Kloon of kopieer de plugin naar uw Shopware custom/plugins/-directory:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Installeer en activeer vervolgens via de Shopware CLI:

bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear

2. De plugin configureren

  1. Ga in uw Shopware-beheer naar Settings → Extensions → NoPayn Payment
  2. Voer uw API Key in van het handelaarsportaal — navigeer naar Websites, klik op de website die u wilt verbinden en klik vervolgens op Integration om uw API-sleutel te vinden
  3. Schakel individuele betaalmethoden in of uit
  4. Sla op

Cost+ handelaarsportaal met API-sleutel

U kunt een andere API-sleutel per verkoopkanaal configureren als u meerdere winkels beheert.

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

3. Betalingsflow

  1. Klant selecteert een betaalmethode bij het afrekenen en plaatst de bestelling
  2. De bestelling wordt aangemaakt met transactiestatus in_progress
  3. Klant wordt doorverwezen naar de NoPayn Hosted Payment Page
  4. Na betaling:
    • Geslaagd — klant keert terug, status wordt geverifieerd via API, transactie ingesteld op paid, bestelling op processing
    • Geannuleerd — klant keert terug, transactie en bestelling ingesteld op cancelled
    • Verlopen (5 minuten time-out) — webhook wordt afgevuurd, transactie en bestelling ingesteld op cancelled

4. Bestellingsstatusmapping

NoPayn-statusTransactiestatusBestellingsstatus
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhooks

De plugin registreert automatisch een webhook-eindpunt op /api/nopayn/webhook. Deze URL wordt naar NoPayn gestuurd bij het aanmaken van bestellingen, wat asynchrone statusbevestiging biedt voor alle transacties.

Handmatige webhookconfiguratie is niet nodig — de plugin handelt de registratie automatisch af.

6. 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.

On this page