DocsShopware
Integrera Cost+ med din Shopware 6-butik via det officiella betalningsplugin
Integrera Cost+ som betalningsmetod i din Shopware 6-butik. Det officiella NoPayn Payment-pluginet stöder flera betalningsmetoder per försäljningskanal och använder Hosted Payment Page-flödet — fullt PCI DSS-kompatibelt.
Förutsättningar
- Aktivt Cost+-handelskonto
- Shopware 6.7 eller senare
- PHP 8.2 eller senare
- SSH- eller terminalåtkomst till din Shopware-server
Betalningsmetoder som stöds
| Kassanamn | Tekniskt namn | NoPayn-identifierare |
|---|---|---|
| Credit / Debit Card | nopayn_credit_card | credit-card |
| Apple Pay | nopayn_apple_pay | apple-pay |
| Google Pay | nopayn_google_pay | google-pay |
| Vipps MobilePay | nopayn_vipps_mobilepay | vipps-mobilepay |
Varje metod kan aktiveras eller inaktiveras per försäljningskanal från plugin-konfigurationen.
1. Installera pluginet
Klona eller kopiera pluginet till din Shopware custom/plugins/-katalog:
cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPaymentInstallera och aktivera sedan via Shopware CLI:
bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear2. Konfigurera pluginet
- I din Shopware-admin, gå till Inställningar → Tillägg → NoPayn Payment
- Ange din API-nyckel från handlarportalen — navigera till Webbplatser, klicka på den webbplats du vill ansluta, sedan klicka på Integration för att hitta din API-nyckel
- Växla individuella betalningsmetoder på eller av
- Spara
Du kan konfigurera en annan API-nyckel per försäljningskanal om du driver flera butiksskyltfönster.
Aktivera bara de betalningsmetoder du har blivit godkänd för och fått bekräftelse på.
3. Betalningsflöde
- Kunden väljer en betalningsmetod i kassan och lägger ordern
- Ordern skapas med transaktionsstatus in_progress
- Kunden omdirigeras till NoPayn Hosted Payment Page
- Efter betalning:
- Lyckad — kunden återvänder, status verifieras via API, transaktion sätts till paid, order sätts till processing
- Avbruten — kunden återvänder, transaktion och order sätts till cancelled
- Utgången (5-minuters timeout) — webhook utlöses, transaktion och order sätts till cancelled
4. Orderstatusmappning
| NoPayn-status | Transaktionsläge | Orderläge |
|---|---|---|
new | in_progress | open |
processing | in_progress | open |
completed | paid | in_progress |
cancelled | cancelled | cancelled |
expired | cancelled | cancelled |
error | cancelled | cancelled |
5. Webhooks
Pluginet registrerar automatiskt en webhook-endpoint på /api/nopayn/webhook. Denna URL skickas till NoPayn vid orderskapande, och ger asynkron statusbekräftelse för alla transaktioner.
Ingen manuell webhook-konfiguration krävs — pluginet hanterar registreringen automatiskt.
6. Testa och lansera
Gör några testtransaktioner för att säkerställa att allt fungerar smidigt. Vi rekommenderar att testa både lyckade och misslyckade betalningar för att bekräfta att alla scenarier hanteras korrekt.
Support
Behöver du hjälp? Kontakta vårt supportteam på support@costplus.io.