Configurazione Square

Collega Square in Impostazioni → Square Booking → Square. Usa la sandbox prima della produzione.

Dove configurare

Le credenziali stanno in Impostazioni → Square Booking → Square. Le altre schede: Appearance, Booking flow, Payments, Analytics, Webhooks, Diagnostics, Advanced e License.

Impostazioni → Square Booking: una scheda per argomento.

Modalità di connessione

Personal Access Token — Plus/Premium. Incolla il token in Access Token.
OAuth — obbligatorio sul piano gratuito. Crea un'app nella dashboard sviluppatori Square, incolla la Redirect URL del plugin, salva Application ID e Secret, poi Connect to Square.

Cambiare sandbox/produzione in OAuth richiede di riconnettere. La sandbox è attiva di default: togli Enable sandbox (disable in production) in produzione. Con OAuth il telefono è obbligatorio.

Location ID

In Locations della stessa app copia l'ID della sede con Appointments. Il widget mostra solo i servizi di quella sede.

Più sedi

La tabella Locations elenca le sedi attive del tuo account Square. Spunta Enabled per ogni sede prenotabile: da due in su il widget inizia con la scelta della sede, e servizi, team e orari seguono quella sede. Le sedi Hidden non sono elencate ma restano prenotabili con [square_booking location_id="…"] o un link. La sede predefinita è sempre il Location ID qui sopra. Clicca Refresh from Square dopo aver aggiunto una sede in Square.

Test connessione

Test Square Connection. Errori: 401, ambienti mescolati, Appointments disattivo, piano gratuito con PAT (passa a OAuth; Diagnostics mostra support_seller_level_writes false).

Pagamenti

Disabled — prenota senza carta (predefinito).
Card on file — salva la carta, 0 $ oggi.
Pay in full now — addebita il prezzo del servizio alla creazione.

Serve un Square Application ID (sandbox e produzione sono diversi). In OAuth, riconnetti per PAYMENTS_WRITE. La Cancellation policy compare al checkout; se vuota si usa il testo Square quando disponibile.

Scheda Payments: carta salvata o pagamento completo con Square Web Payments.

Opzioni di visualizzazione

Nella scheda Booking flow (Widget Content): descrizioni, immagini, nome del membro del team. Deseleziona Show the All services link per nascondere il breadcrumb verso l'elenco servizi; il pulsante Back ci torna comunque.

Domande di intake

Lascia vuoto Custom Intake Questions per caricare il modulo Square (Appointments → Settings → Intake Form). Il JSON in quel campo ha priorità. Tipi: TEXT, DROPDOWN, CHECKBOX, TEXT_CONDITIONAL.

Vedi Risoluzione problemi.