Drupal Commerce

Integra Cost+ come metodo di pagamento nel tuo negozio Drupal Commerce. Il modulo ufficiale NoPayn Payment Gateway utilizza il flusso della Pagina di Pagamento Ospitata, quindi nessun dato della carta passa attraverso il tuo server — completamente conforme PCI DSS.

Prerequisiti

• Account commerciante Cost+ attivo
• Drupal 10 o 11
• Drupal Commerce 3.x
• PHP 8.1 o successivo
• Accesso amministratore al tuo sito Drupal

Metodi di Pagamento Supportati

• Carta di Credito / Debito — Visa, Mastercard e altri
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Installa il Modulo

Copia il modulo commerce_nopayn nella tua installazione Drupal e abilitalo:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Aggiungi un Gateway di Pagamento

1. Vai a Commerce → Configurazione → Gateway di pagamento (/admin/commerce/config/payment-gateways)
2. Clicca Aggiungi gateway di pagamento
3. Seleziona NoPayn Payment Gateway come plugin

3. Configura il Gateway

Inserisci le seguenti impostazioni:

• Chiave API NoPayn — La tua chiave API commerciante dal Portale Commerciante
• Metodi di Pagamento — Abilita o disabilita Carta di Credito, Apple Pay, Google Pay, Vipps MobilePay
• Modalità — Imposta su Test quando usi una chiave API da un sito web sandbox, o Live quando usi una chiave di un sito web di produzione

Impostazioni Opzionali

• Cattura Manuale — Autorizza i pagamenti con carta di credito senza cattura immediata (i fondi vengono riservati, poi catturati quando l'ordine viene evaso)
• Logging di Debug — Abilita per registrare tutte le richieste e risposte API nel log di Drupal per la risoluzione dei problemi

Clicca Salva quando hai finito.

4. Flusso di Pagamento

Una volta configurato, il flusso di pagamento funziona come segue:

1. Il cliente aggiunge prodotti al carrello e procede al checkout
2. Al passaggio del pagamento, i metodi Cost+ abilitati vengono mostrati come pulsanti radio
3. Il cliente seleziona un metodo e conferma l'ordine
4. Il modulo crea un ordine tramite l'API Cost+ e reindirizza alla pagina di pagamento ospitata
5. Il cliente completa il pagamento sulla pagina Cost+
6. Il cliente ritorna al negozio — il pagamento viene verificato tramite API
7. Un webhook da Cost+ conferma in modo asincrono il risultato del pagamento

5. Configurazione del Webhook

L'URL del webhook viene generato automaticamente da Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

Ad esempio: https://your-store.com/payment/notify/nopayn

Questo URL deve essere accessibile da internet senza autenticazione. Il modulo verifica sempre lo stato del pagamento tramite l'API — non si fida mai solo del payload del webhook.

Cattura Manuale

Quando la cattura manuale è abilitata per le carte di credito:

1. La carta del cliente viene autorizzata (fondi riservati) durante il checkout
2. La cattura avviene automaticamente quando l'ordine passa a Evaso
3. Se l'ordine viene annullato, l'autorizzazione viene annullata tramite webhook

Rimborsi

I rimborsi possono essere elaborati direttamente dal pannello di amministrazione Commerce. Sono supportati sia i rimborsi totali che quelli parziali.

Tabelle del Database

Il modulo crea due tabelle per il tracciamento:

Disinstallazione

drush pmu commerce_nopayn -y
drush cr

Testa e Lancia

Effettua alcune transazioni di test per assicurarti che tutto funzioni correttamente. Imposta la Modalità del gateway su Test e verifica sia i pagamenti riusciti che quelli falliti prima di passare a Live.

Supporto

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