Shopware

Integra Cost+ con il tuo negozio Shopware 6 utilizzando il plugin ufficiale di pagamento

Integra Cost+ come metodo di pagamento nel tuo negozio Shopware 6. Il plugin ufficiale NoPayn Payment supporta più metodi di pagamento per canale di vendita e utilizza il flusso della Pagina di Pagamento Ospitata — completamente conforme PCI DSS.

Prerequisiti

Account commerciante Cost+ attivo
Shopware 6.7 o successivo
PHP 8.2 o successivo
Accesso SSH o terminale al tuo server Shopware

Metodi di Pagamento Supportati

Nome al Checkout	Nome Tecnico	Identificativo NoPayn
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`

Ogni metodo può essere abilitato o disabilitato per canale di vendita dalla configurazione del plugin.

1. Installa il Plugin

Clona o copia il plugin nella directory custom/plugins/ del tuo Shopware:

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

Poi installa e attiva tramite la CLI di Shopware:

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

2. Configura il Plugin

Nel pannello di amministrazione Shopware, vai a Impostazioni → Estensioni → NoPayn Payment
Inserisci la tua chiave API dal Portale Commerciante — vai a Siti Web, clicca sul sito web che vuoi collegare, poi clicca Integrazione per trovare la tua chiave API
Attiva o disattiva i singoli metodi di pagamento
Salva

Portale Commerciante Cost+ che mostra la chiave API

Puoi configurare una chiave API diversa per canale di vendita se gestisci più vetrine.

Attiva solo i metodi di pagamento per cui sei stato approvato e hai ricevuto conferma.

3. Flusso di Pagamento

Il cliente seleziona un metodo di pagamento al checkout e conferma l'ordine
L'ordine viene creato con stato della transazione in_progress
Il cliente viene reindirizzato alla Pagina di Pagamento Ospitata NoPayn
Dopo il pagamento:
- Successo — il cliente ritorna, lo stato viene verificato tramite API, transazione impostata a paid, ordine impostato a processing
- Annullato — il cliente ritorna, transazione e ordine impostati a cancelled
- Scaduto (timeout di 5 minuti) — il webhook si attiva, transazione e ordine impostati a cancelled

4. Mappatura degli Stati dell'Ordine

Stato NoPayn	Stato Transazione	Stato Ordine
`new`	in_progress	open
`processing`	in_progress	open
`completed`	paid	in_progress
`cancelled`	cancelled	cancelled
`expired`	cancelled	cancelled
`error`	cancelled	cancelled

5. Webhook

Il plugin registra automaticamente un endpoint webhook a /api/nopayn/webhook. Questo URL viene inviato a NoPayn durante la creazione degli ordini, fornendo una conferma asincrona dello stato per tutte le transazioni.

Non è richiesta alcuna configurazione manuale del webhook — il plugin gestisce la registrazione automaticamente.

6. Testa e Lancia

Effettua alcune transazioni di test per assicurarti che tutto funzioni correttamente. Ti consigliamo di testare sia i pagamenti riusciti che quelli falliti per confermare che tutti gli scenari vengano gestiti correttamente.

Supporto

Hai bisogno di aiuto? Contatta il nostro team di supporto a support@costplus.io.

On this page