In vista del passaggio al widget 5.2, ci sono due verifiche da fare sull’integrazione: lo script V5 e il merchant token. Ecco le risposte alle domande più comuni.

Cosa devo controllare prima del passaggio?

Due cose: che il sito carichi lo script del widget V5 e che ogni widget riporti il merchant token. Se entrambe le condizioni sono soddisfatte, il passaggio alla 5.2 avviene in automatico.

Come faccio a verificarlo velocemente?

Bastano un paio di minuti. Apri una pagina prodotto, visualizza il codice sorgente e cerca scalapay-widget. Lì puoi leggere l’indirizzo dello script caricato e l’attributo merchant-token.

Cosa succede il giorno del passaggio?

Con script V5 e merchant token, il widget passa automaticamente alla 5.2. Con script V5 ma senza token, resta sulla 5.1. Con script V3, V1 o loader senza versione, resta il vecchio widget e la 5.2 non arriva finché il merchant non aggiorna l’integrazione.

Merchant con plugin o app e-commerce

Il mio shop usa WooCommerce, PrestaShop, Magento o Shopify. Cosa devo fare?

Aggiorna il plugin. Verifica di avere l’ultima versione del plugin Scalapay e, se necessario, installala dal marketplace della tua piattaforma o da developers.scalapay.com. Le versioni vecchie caricano il widget V3, che non riceverà mai la 5.2.

Dove inserisco il merchant token?

Nelle impostazioni del widget del plugin, inserendo il merchant token del Merchant Portal. Se il plugin non ha un campo per il merchant token, è obsoleto: va aggiornato prima.

Come verifico che tutto sia corretto?

Svuota la cache dello shop, apri una pagina prodotto e controlla il codice sorgente: devi trovare lo script V5 e un merchant-token su ogni widget.

Merchant con integrazione custom

Il widget è inserito nel codice o nel tema del sito. Quale script devo caricare?

Esattamente questo: https://cdn.scalapay.com/widget/v5/js/scalapay-widget.js

Come riconosco uno script obsoleto?

È obsoleto qualsiasi indirizzo con /widget/v3/ o /js/scalapay-widget/ (V1), così come il loader senza ?version=V5, che carica la V3.

Dove va inserito il merchant token?

In ogni tag <scalapay-widget> (pagina prodotto, carrello, checkout), con l’attributo merchant-token='…' contenente il token del Merchant Portal scritto esattamente com’è.

Devo cambiare anche gli attributi del widget?

Sì, va usato il modello dati della 5.2. Gli attributi della V3, come number-of-installments, sulla V5 non hanno effetto e vanno rimossi.

In sintesi

Script V5 e merchant token su ogni widget: con questi due elementi il passaggio alla 5.2 avviene da solo.