Pagamenti

Configurare Square

Ricevi pagamenti con carta tramite Square nel tuo widget di prenotazione e sulla tua pagina di prenotazione. I clienti pagano con carta, e Apple Pay e Google Pay funzionano appena registri il tuo sito. Il denaro arriva direttamente sul tuo account Square. FullClass non lo riceve né lo trattiene mai.

Cosa ottieni Cosa ti serve Configurazione in sandbox Provare una prenotazione Apple Pay e Google Pay Passare in modalità live Chiave di firma dei webhook Rimborsi Carte regalo nella tua contabilità Risoluzione dei problemi

Cosa ottieni

  • Configurazione con un clic, accedendo a Square. Non c'è nulla da copiare o incollare, e FullClass rinnova il collegamento per te.
  • Un modulo carta dentro il tuo widget di prenotazione. Lo fornisce Square, quindi i numeri delle carte vanno direttamente a Square.
  • Apple Pay e Google Pay sui siti che registri. Non devi aggiungere nessun file al tuo sito.
  • Rimborsi che puoi fare dalla pagina della prenotazione nell'amministrazione.
  • Se vuoi, la sincronizzazione dei rimborsi che fai in Square, così si aggiorna anche la prenotazione in FullClass™. Usa un webhook (vedi sotto).

Cosa ti serve

  • Un account Square.
  • L'accesso da titolare a FullClass. Solo il titolare può aprire le impostazioni di pagamento.
  • Circa 15 minuti per configurare una prova, più una breve prenotazione di prova.

Collegarsi con Square (il modo semplice)

Con Collegati con Square non copi nulla. FullClass inserisce per te i tuoi dati Square e imposta Square come modo in cui pagano i clienti.

  1. Accedi a FullClass come titolare e apri Impostazioni → Pagamenti.
  2. In Scegli come pagano i clienti, scegli Square. Poi clicca su Collegati con Square.
  3. Accedi a Square e autorizza l'accesso. Torni alla pagina Pagamenti, che dice Square collegato correttamente.
  4. Tutto qui. Per smettere in seguito di ricevere pagamenti Square, clicca su Scollega nella stessa pagina.
I rinnovi sono automatici. Accedere a Square dà a FullClass un pass che rinnova per te. Il tuo collegamento continua a funzionare e non devi mai inserire di nuovo nulla. Preferisci incollare tu i tuoi dati? Apri Inserisci invece le credenziali manualmente e segui i passaggi qui sotto.
Non vedi il pulsante? Usa la configurazione manuale qui sotto. Una volta salvata, funziona esattamente allo stesso modo.

Configurazione in sandbox (consigliata per prima)

La sandbox è la modalità test di Square. Puoi prenotare e pagare con numeri di carte di prova, e non si muove denaro reale. Prova prima lì. Quando sei soddisfatto, inserisci i tuoi dati live, che Square chiama "production".

Passo 1. Recupera i tuoi dati Square

  1. Accedi a developer.squareup.com. È il sito di Square per collegare altre app, come FullClass.
  2. Apri un'applicazione esistente, oppure creane una nuova. Qui un'applicazione è solo un collegamento con un nome al tuo account Square.
  3. In Credentials, copia l'Application ID (il nome del collegamento) e l'Access token (la sua password segreta). Gli ID della sandbox iniziano con sandbox-. Gli ID di production iniziano con sq0idp-.
  4. Apri Locations nella stessa app, o nella tua Square Dashboard. Copia il Location ID della sede che deve ricevere i pagamenti.
FullClass capisce da solo se è test o live. Legge l'inizio dell'Application ID per distinguere la sandbox da production. Non c'è nessun interruttore da impostare. Copia solo tutti i tuoi dati dalla stessa scheda in Square.

Passo 2. Incolla i dati in FullClass

  1. Accedi a FullClass come titolare.
  2. Apri Impostazioni → Pagamenti.
  3. In Scegli come pagano i clienti, scegli Square. Se vedi Collegati con Square, apri Inserisci invece le credenziali manualmente per arrivare ai campi.
  4. Incolla l'Application ID, l'Access token e il Location ID.
  5. Clicca su Salva le modifiche. (Puoi aggiungere la chiave facoltativa dei webhook più tardi, vedi sotto.)
Passare a Stripe in seguito. Quando Square è configurato, non puoi scegliere Stripe, così un clic per sbaglio non può farti perdere i tuoi dati Square. Per passare a Stripe, clicca prima su Scollega. Questo cancella i dati Square salvati, e poi puoi scegliere Stripe. Per cambiare i tuoi dati Square, ti basta modificarli e salvare. Non devi scollegare nulla.

Prova una prenotazione dall'inizio alla fine

  1. Apri la tua pagina di prenotazione, come farebbe un cliente.
  2. Scegli un evento a pagamento e compila il modulo di prenotazione.
  3. Paga con una carta di prova della sandbox Square. Square le elenca nella sua pagina carte di prova della sandbox Square.
  4. Controlla che la prenotazione compaia nell'amministrazione, pagata tramite Square, con un ID pagamento Square.
La modalità test in FullClass. Finché sono salvati i tuoi dati della sandbox, FullClass è in modalità test. Ogni pagina dell'amministrazione mostra un avviso Modalità di test. La tua pagina di prenotazione mostra un avviso che dice che non verrà preso nessun pagamento reale. Entrambi gli avvisi spariscono appena salvi i tuoi dati di production. Tutto ciò che vendi in modalità test resta fuori dai report dei ricavi e dagli incassi della dashboard, anche dopo il passaggio in modalità live. Per saperne di più, vedi Prova le prenotazioni prima di passare in modalità live.

Apple Pay e Google Pay

Square controlla il tuo sito da sé, quindi non c'è nessun file da aggiungere. Apri Impostazioni → Pagamenti → Domini di pagamento con wallet. Trova ogni sito in cui compare il tuo widget e clicca su Registra.

Per tutti i passaggi e le soluzioni, vedi Apple Pay e Google Pay.

Rimuovere un sito registrato. Square non permette ad altre app di rimuovere un sito registrato. Eliminarlo in FullClass lo toglie solo dal tuo elenco. Per rimuoverlo anche da Square, contatta l'assistenza di Square.

Passare in modalità live

  1. Su developer.squareup.com, passa alla scheda Production.
  2. Copia l'Application ID di production (inizia con sq0idp-), l'Access token e il Location ID.
  3. Incollali in Impostazioni → Pagamenti in FullClass e clicca su Salva le modifiche.
  4. Fai una piccola prenotazione reale. Poi rimborsala dalla pagina della prenotazione, per controllare che funzionino sia i pagamenti sia i rimborsi.

Chiave di firma dei webhook (facoltativa, consigliata)

Un webhook è un messaggio che Square invia a FullClass quando qualcosa cambia in Square. Senza, un rimborso che fai dentro Square (non dall'amministrazione di FullClass) non compare sulla prenotazione. La chiave di firma dei webhook è un segreto che permette a FullClass di controllare che ogni messaggio arrivi davvero da Square.

  1. Su developer.squareup.com, apri la scheda Webhooks della tua app.
  2. Aggiungi un'iscrizione webhook che punti a https://your-fullclass-domain/webhooks/square.
  3. Iscriviti agli eventi di rimborso.
  4. Square crea una signature key. Copiala.
  5. Incollala nel campo Chiave di firma dei webhook in Impostazioni → Pagamenti in FullClass.
I messaggi live hanno bisogno della chiave. In production, FullClass rifiuta i messaggi webhook di Square che non sono firmati con una chiave valida. Se hai un'iscrizione webhook di Square attiva, assicurati che la sua chiave di firma sia salvata qui.
Ti sei collegato con l'accesso a Square? La chiave dei webhook è separata dall'accesso. Perché i rimborsi che fai dentro Square arrivino alle tue prenotazioni, aggiungi comunque l'iscrizione webhook e incolla qui la sua chiave di firma. Apri Aggiorna le credenziali manualmente per trovare il campo. Gli addebiti e i rimborsi che fai in FullClass funzionano anche senza.

Rimborsi

  • Rimborsa dalla pagina della prenotazione nell'amministrazione. Puoi rimborsare l'intero importo o una parte.
  • Se hai configurato anche il webhook qui sopra, i rimborsi che fai in Square (per esempio dalla Square Dashboard) aggiornano da soli la prenotazione.

Un rimborso da FullClass arriva in Square come un importo di denaro, non come il reso degli articoli venduti. Questo perché Square non permette ad altre app di rendere singoli articoli. Se Square è sincronizzato con QuickBooks Online, il rimborso viene registrato sull'articolo Square sales item senza imposte, qualunque fosse la vendita originale. Chiedi al tuo contabile di correggere questi rimborsi come segue.

  • Rimborsi di carte regalo (una carta con un saldo in denaro): sposta l'importo dai ricavi di vendita al conto di passività delle carte regalo, dove è stata registrata la vendita.
  • Altri rimborsi (prenotazioni, carnet di lezioni, eventi privati): sposta l'imposta inclusa nel rimborso dai ricavi di vendita al conto delle imposte sulle vendite da versare.

Ogni rimborso in QuickBooks Online riporta la descrizione della vendita originale, come Gift card purchase o il numero di prenotazione. Usala per trovarli.

Carte regalo nella tua contabilità

Una carta regalo venduta tramite Square arriva in Square come una vendita con un solo articolo. Così la tua contabilità può distinguerla dai ricavi delle lezioni.

  • Gift card: una carta con un saldo in denaro e senza imposte. L'imposta si applica più tardi, quando la carta paga una lezione.
  • Class pass: un carnet per un certo numero di lezioni. Porta l'imposta che imposti per i carnet nelle impostazioni delle carte regalo.

Se Square è sincronizzato con QuickBooks Online, associa l'articolo Gift card al conto di passività delle carte regalo, non ai ricavi di vendita. Così le carte non usate non vengono contate come ricavi.

Una carta regalo rimborsata non segue questa associazione. Vedi Rimborsi per la correzione da fare.

Risoluzione dei problemi

Il modulo carta non compare
Controlla che Square sia scelto in Scegli come pagano i clienti, e che tutti e tre i dati siano salvati. L'Application ID decide se è test o live, quindi un Access token dell'altra scheda fa fallire il controllo della carta.
Il controllo della carta non riesce
L'Application ID e l'Access token devono venire dalla stessa scheda in Square (Sandbox o Production). Non puoi mescolarli.
Manca il pulsante Apple Pay su un sito registrato
Controlla il browser del cliente. Apple Pay richiede Safari su un Mac, un iPhone o un iPad. Google Pay richiede Chrome con una carta di pagamento configurata. Controlla anche che il sito risulti Registrato in Domini di pagamento con wallet.
Un rimborso fatto in Square non ha aggiornato la prenotazione
Ti servono un'iscrizione webhook in Square e una chiave di firma salvata in FullClass. Vedi Chiave di firma dei webhook.

Vedi anche Risoluzione dei problemi → Il pagamento non riesce.

← Torna aRicevere pagamenti
Centro assistenza FullClass · Configurare Square