{"id":841322,"date":"2026-09-09T12:21:13","date_gmt":"2026-09-09T12:21:13","guid":{"rendered":"https:\/\/www.knowband.com\/blog\/?p=841317\/"},"modified":"2026-09-30T08:38:36","modified_gmt":"2026-09-30T08:38:36","slug":"prestashop-payment-gateway-integration","status":"publish","type":"post","link":"https:\/\/www.knowband.com\/blog\/it\/ecommerce-blog\/prestashop-payment-gateway-integration\/","title":{"rendered":"Integrazione di un gateway di pagamento personalizzato in PrestaShop: requisiti tecnici, flusso API e sfide OPC reali"},"content":{"rendered":"

Integrare un gateway di pagamento in PrestaShop pu\u00f2 sembrare semplice sulla carta.<\/span><\/p>\n

Il gateway fornisce la documentazione API, le credenziali di accesso alla sandbox, le chiavi di autenticazione, gli URL di callback e alcuni endpoint. Il modulo PrestaShop invia quindi la richiesta di pagamento, riceve la risposta, crea l’ordine e reindirizza il cliente alla pagina di conferma.<\/span><\/p>\n

In un vero negozio PrestaShop, tuttavia, il gateway di pagamento raramente funziona da solo.<\/span><\/p>\n

Nel momento in cui un negozio utilizza un modulo One Page Checkout (OPC) come SuperCheckout, pi\u00f9 moduli di pagamento, flussi di pagamento personalizzati, iframe, metodi di pagamento basati su JavaScript e ulteriori personalizzazioni del checkout possono interagire tra loro.<\/span><\/p>\n

\u00c8 proprio qui che molte integrazioni di pagamento diventano complesse.<\/span><\/p>\n

Durante i lavori di compatibilit\u00e0 con i gateway di pagamento, abbiamo riscontrato casi in cui un metodo di pagamento funzionava perfettamente con il checkout predefinito di PrestaShop, ma si comportava in modo diverso all’interno di OPC. Ad esempio, un fornitore di pagamento poteva essere visualizzato correttamente nel checkout standard, mentre opzioni come BLIK, selezione della banca o BNPL (Buy Now Pay Later) scomparivano all’interno di SuperCheckout.<\/span><\/p>\n

La lezione pi\u00f9 importante \u00e8 stata che integrare un gateway di pagamento non significa solo far funzionare la chiamata API, ma far s\u00ec che l’intero ciclo di pagamento funzioni correttamente all’interno del checkout di PrestaShop.<\/span><\/p>\n

1.0 Di cosa ha effettivamente bisogno un gateway di pagamento personalizzato?<\/strong><\/h2>\n

\"Di<\/a><\/p>\n

A grandi linee, un’integrazione di pagamento per PrestaShop deve gestire cinque aspetti:<\/span><\/p>\n

    \n
  1. Visualizza il metodo di pagamento al momento del checkout.<\/span><\/li>\n
  2. Invia i dati del cliente o di pagamento al gateway.<\/span><\/li>\n
  3. Ricevere e convalidare la risposta del gateway.<\/span><\/li>\n
  4. Creare o aggiornare correttamente l’ordine PrestaShop.<\/span><\/li>\n
  5. Reindirizzare il cliente alla pagina di conferma o di errore appropriata.<\/span><\/li>\n<\/ol>\n

    Un tipico modulo di pagamento estende la classe base anzich\u00e9 la classe base.<\/p>\n

    Il modulo di pagamento funziona normalmente con hook come:<\/p>\n

    Il componente hook ha il compito di rendere disponibile il metodo di pagamento al momento del checkout.<\/p>\n

    Il hook gestisce ci\u00f2 che il cliente vede dopo essere tornato dalla procedura di pagamento.<\/p>\n

    Per esempio:<\/span><\/p>\n

    public function hookPaymentOptions($params) { if (!$this->active || !$this->checkCurrency($params['cart'])) { return []; } $paymentOption = new PaymentOption(); $paymentOption ->setCallToActionText($this->l('Paga con carta')) ->setAction( $this->context->link->getModuleLink( $this->name, 'redirect', [], true ) ); return [$paymentOption]; }<\/pre>\n
    Il punto fondamentale \u00e8 che questo hook non deve dare per scontato che il metodo di pagamento sia sempre visibile.<\/span><\/p>\n
    Valuta, paese, corriere, stato del cliente, importo del carrello, configurazione del modulo e disponibilit\u00e0 del gateway possono influire sulla visualizzazione del metodo di pagamento.<\/span><\/p>\n
    2.0 La parte che cambia tutto: OPC<\/strong><\/h2>\n
    Il sistema di pagamento predefinito di PrestaShop e un modulo OPC non elaborano necessariamente i metodi di pagamento esattamente allo stesso modo.<\/span><\/p>\n
    Questa \u00e8 stata una delle lezioni pi\u00f9 importanti apprese lavorando con diversi moduli di pagamento.<\/span>
    \n<\/span><\/p>\n
    Con la procedura di pagamento predefinita, un modulo di pagamento generalmente gestisce autonomamente la visualizzazione delle opzioni di pagamento e il flusso di pagamento.<\/span><\/p>\n
    Con un OPC, il modulo di checkout diventa un ulteriore livello tra il modulo di pagamento e il cliente. Ci\u00f2 significa che possono interagire i seguenti elementi:<\/span><\/p>\n
     <\/b>\r\n\u2193<\/span>\r\nOPC \/ SuperCheckout<\/b>\r\n\u2193<\/span>\r\nOpzioni di pagamento<\/b>\r\n\u2193<\/span>\r\nModulo di pagamento<\/b>\r\n\u2193<\/span>\r\nAPI del gateway<\/b>\r\n\u2193<\/span>\r\nRisposta del gateway<\/b>\r\n\u2193<\/span>\r\nModulo di pagamento<\/b>\r\n\u2193<\/span>\r\nOPC \/ PrestaShop<\/b>\r\n\u2193<\/span>\r\nConferma dell'ordine<\/b><\/pre>\n
    Un modulo di pagamento pu\u00f2 quindi essere perfettamente corretto dal punto di vista dell’API e tuttavia non funzionare correttamente all’interno di un OPC.<\/span><\/p>\n
    Ecco perch\u00e9 i test di compatibilit\u00e0 dei pagamenti dovrebbero sempre includere entrambi:<\/span><\/p>\n