VibeFox 2C2P for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

WooCommerce: 6.0 o successivo, installato e attivo. Senza WooCommerce il plugin mostra un avviso nell'area di amministrazione e il metodo di pagamento non viene caricato.

PHP: 8.0 o successivo.

Account 2C2P: ti servono il Merchant ID e la Secret Key del tuo account commerciante 2C2P. Vengono rilasciati da 2C2P all'apertura del tuo account commerciante. Gli account sandbox e quelli live hanno chiavi diverse. La documentazione per sviluppatori e le carte di prova della sandbox si trovano su developer.2c2p.com.

Valuta: la valuta del negozio deve essere supportata dal plugin e abilitata nel tuo account 2C2P. Sono supportate, tra le altre, THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR e GBP. Se la valuta del negozio non è supportata, il metodo di pagamento non viene mostrato al checkout.

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. Puoi anche caricare la cartella wcp_2c2p_payment in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > 2C2P > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Inserisci il Merchant ID e la Secret Key della sandbox, attiva Enable/Disable e fai un ordine di prova.

6. Quando sei pronto, inserisci le credenziali live e deseleziona Sandbox Mode.

Gli URL di ritorno e di notifica vengono inviati con ogni pagamento. Non serve configurare nulla nel portale 2C2P.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > 2C2P. Sopra i campi la pagina mostra Sandbox mode is active. No real transactions will be processed. finché la modalità sandbox è attiva. Ti avvisa quando il gateway è abilitato ma il Merchant ID o la Secret Key della modalità corrente sono vuoti, e quando la valuta del negozio non è supportata. In entrambi i casi il metodo di pagamento viene nascosto al checkout. Quando salvi con Sandbox Mode disattivato, il plugin chiede il Merchant ID e la Secret Key live se sono vuoti.

Generali

Enable/Disable: Enable 2C2P Payment Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che i clienti vedono al checkout. Predefinito: 2C2P Payment.

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. In modalità sandbox viene aggiunto (TEST MODE).

Modalità di test (sandbox)

Sandbox Mode: Enable sandbox / test mode invia i pagamenti alla sandbox 2C2P (demo2.2c2p.com) con le credenziali sandbox indicate sotto. Predefinito: attivato. Deselezionala per accettare pagamenti reali.

Sandbox Merchant ID: il tuo Merchant ID 2C2P della sandbox.

Sandbox Secret Key: la tua Secret Key 2C2P della sandbox.

Credenziali API live

Usate quando la modalità sandbox è disattivata.

Merchant ID: il tuo Merchant ID 2C2P live. Obbligatorio quando la modalità sandbox è disattivata.

Secret Key: la tua Secret Key 2C2P live. Obbligatoria quando la modalità sandbox è disattivata. La chiave viene salvata esattamente come inserita, comprese virgolette e barre rovesciate.

Pagina di pagamento

Questa sezione mostra, a titolo informativo, l'URL di ritorno lato cliente (https://your-site/?wc-api=tc2p_p) e l'URL di notifica lato server (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1). Vengono inviati automaticamente con ogni pagamento.

Payment Page Language: la lingua della pagina di pagamento 2C2P. Predefinito: English.

Redirect API version: lascia 8.5, a meno che 2C2P non ti abbia comunicato che il tuo account usa ancora la versione 7.0 (firme SHA-1). Gli esiti dei pagamenti avviati prima di un cambio vengono comunque verificati.

Order ID prefix: facoltativo, solo lettere e cifre (massimo 10), per esempio SHOP1. 2C2P rifiuta un ID ordine già ricevuto. Imposta un prefisso univoco quando più negozi condividono un account 2C2P e nella sandbox, dove gli account commerciante di prova sono condivisi. Gli altri caratteri vengono rimossi al salvataggio, con un avviso.

Impostazioni avanzate

Enable Logging: Log 2C2P events scrive in WooCommerce > Status > Logs, origine wcp_2c2p_payment. Non vengono registrati dati della carta né chiavi segrete. Predefinito: disattivato.

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita 2C2P Payment) e fa l'ordine. La pagina successiva mostra Thank you for your order. You will be redirected to 2C2P to complete your payment. e, dopo un momento, invia il cliente alla pagina di pagamento 2C2P. Se ciò non accade, il cliente fa clic su Pay via 2C2P. La pagina ha anche un pulsante Cancel order.

Sulla pagina di 2C2P il cliente paga con uno qualsiasi dei metodi attivi sul tuo account 2C2P, per esempio carte, portafogli elettronici, pagamenti QR, internet banking o pagamenti in contanti. Il plugin trasmette il totale dell'ordine nella valuta dell'ordine, l'e-mail di fatturazione del cliente e i nomi dei prodotti ordinati. Il pagamento può essere completato entro 24 ore.

2C2P comunica l'esito due volte: il browser del cliente torna al negozio e 2C2P invia una notifica server-to-server. Entrambi vengono gestiti allo stesso modo. L'ordine viene segnato come pagato solo dopo che 2C2P lo conferma con una firma valida. L'esito deve anche riferirsi all'ordine: vengono verificati il Merchant ID, la chiave dell'ordine, l'ID ordine e il metodo di pagamento. Gli esiti senza una firma valida vengono rifiutati.

Dopo un pagamento riuscito o in attesa, il cliente arriva alla pagina Ordine ricevuto e il carrello viene svuotato. Se il pagamento non è stato completato, il cliente torna al checkout con il messaggio Payment was not completed. Please try again or choose a different payment method. L'ordine viene annullato, il carrello viene conservato e il cliente effettua un nuovo ordine. Se l'esito non può essere confermato, il cliente vede We could not confirm the payment result. If your account was charged, please contact us before paying again.

Il metodo di pagamento funziona con il checkout classico e con il blocco Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin non gestisce rimborsi da WooCommerce, non salva le carte, non gestisce pagamenti ricorrenti né WooCommerce Subscriptions, non include campi carta sul tuo sito e non supporta l'API 2C2P PGW 4.x.

Ordini

Stati dell'ordine

Pending payment: il cliente è stato inviato a 2C2P e non è ancora arrivato alcun esito.

Processing or Completed: 2C2P ha comunicato un pagamento riuscito (stato 000). WooCommerce imposta Processing, oppure Completed per gli ordini con solo prodotti virtuali scaricabili. La nota dell'ordine mostra la transazione 2C2P, il codice di approvazione, la data e il canale di pagamento. L'ID transazione è il riferimento della transazione 2C2P.

On hold: il pagamento è in attesa presso 2C2P (stato 001), per esempio un pagamento in contanti non ancora effettuato dal cliente. L'ordine risulta pagato quando 2C2P comunica il pagamento. Un ordine viene anche messo in sospeso quando 2C2P comunica un importo o una valuta diversi dal totale dell'ordine. La nota dell'ordine mostra i valori ricevuti e quelli attesi. Verifica l'ordine e la transazione nel portale 2C2P.

Cancelled: il pagamento è stato rifiutato, annullato dal cliente o non è riuscito (stati 002, 003, 999). La nota dell'ordine mostra lo stato e il motivo.

Un ordine pagato o rimborsato non viene mai modificato da un esito successivo, e un esito vecchio ripetuto non riapre un ordine che hai annullato.

Rimborsi

I rimborsi da WooCommerce non sono supportati. Effettua il rimborso del pagamento nel portale commerciante 2C2P, poi crea un rimborso manuale in WooCommerce.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > 2C2P. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino alla quale la licenza è attiva e il tuo dominio. Usa Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un solo dominio. Rimuovere la chiave da un sito non libera il posto del dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, il metodo di pagamento 2C2P non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio che hanno effettuato l'accesso vedono ancora il metodo di pagamento, contrassegnato da (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente in background.

Risoluzione dei problemi

2C2P non appare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo e che la modalità corrente abbia un Merchant ID e una Secret Key: i campi sandbox in modalità sandbox, i campi live in modalità live. Verifica che la valuta del negozio sia supportata. La pagina delle impostazioni mostra un avviso in entrambi i casi.

Il pagamento è andato a buon fine, ma l'ordine resta Pending payment: nessun esito valido è arrivato al tuo negozio. Verifica che il Merchant ID e la Secret Key della modalità corrente corrispondano all'account 2C2P con cui è stato effettuato il pagamento, e che Redirect API version corrisponda al tuo account. Un esito con firma errata o per un altro Merchant ID viene rifiutato. Attiva Enable Logging e cerca i messaggi relativi a hash o Merchant ID in WooCommerce > Status > Logs. Verifica inoltre che il tuo server accetti le richieste di 2C2P verso l'URL di notifica lato server.

2C2P segnala che l'ID ordine esiste già: 2C2P non accetta lo stesso ID ordine due volte. Succede quando più negozi condividono un account 2C2P oppure nella sandbox, dove gli account commerciante demo sono condivisi da molti sviluppatori. Imposta un Order ID prefix univoco.

È stato effettuato un pagamento, ma l'ordine è On hold: il pagamento è ancora in attesa presso 2C2P (per esempio un pagamento in contanti non ancora effettuato dal cliente), oppure l'importo o la valuta pagati non corrispondevano all'ordine. Controlla le note dell'ordine e la transazione nel portale 2C2P.

Il cliente vede This payment method is currently unavailable for this order: la valuta dell'ordine non è supportata, oppure il Merchant ID o la Secret Key della modalità corrente sono vuoti.

Please enter your live Merchant ID or Please enter your live Secret Key on save: la modalità sandbox è disattivata e un campo live è vuoto. Inserisci le credenziali live oppure lascia attivo Sandbox Mode.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera un posto nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

Disattivare il plugin mantiene tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway, i dati 2C2P salvati negli ordini e i file di log vengono rimossi solo se Delete Data on Uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli ordini esistenti mantengono le note di pagamento e gli ID transazione.

2C2P è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da 2C2P.