1. Argomenti
  2. Pagamenti
  3. Square Integrazione del pagamento

Square Integrazione del pagamento

 

FooSales si integra con l'hardware Square per acquisire i pagamenti con carta direttamente all'interno delle applicazioni FooSales per un'esperienza di checkout senza soluzione di continuità. Non è necessario sincronizzare i cataloghi dei prodotti tra il negozio WooCommerce e l'account Square. I totali degli ordini vengono inviati a Square al momento del checkout e dopo che il pagamento è stato completato con successo, FooSales completa automaticamente l'ordine di WooCommerce.

Nota: il componente aggiuntivo Pagamenti FooSales Square è necessario per l'integrazione Square, che è disponibile come optional quando si acquista un Piano a dominio singolo o multiplo ed è anche disponibile separatamente se si desidera aggiungerlo a un piano esistente.

Requisiti #

Per l'integrazione del pagamento Square sono necessari i seguenti elementi:

Impostazione #

Se si prevede di integrare l'FooSales con un sistema Square Stand, Lettore per magstripe o Lettore per contactless e chipassicurarsi di avere il Square Punto vendita e pagamento installata sull'iPad o sul tablet Android che si utilizzerà per l'FooSales.

Una volta scaricato e installato il programma Square Punto vendita e pagamento sulla tavoletta, accedere all'applicazione utilizzando il proprio account Conto Square nome utente e password.

Affinché l'app FooSales e l'app Square Point of Sale possano comunicare tra loro, è necessario che creare un nuovo o aggiornare un file esistente Applicazione Square nel vostro Cruscotto dello sviluppatore Square.

Creare una nuova applicazione Square #

Aprite il vostro Cruscotto dello sviluppatore Square e scegliere Nuova applicazione, Creare la prima applicazione se si tratta di un nuovo account OPPURE Aperto un'applicazione precedentemente creata, se ne esiste già una nel vostro account.

Square Cruscotto dello sviluppatore Crea applicazione

Quando si crea un nuova applicazioneè necessario inserire un nome dell'applicazione e accettare il Termini di servizio dello sviluppatore Square.

. Quindi, aprire l'applicazione appena creata o quella esistente. Se si è creata una nuova applicazione, questa verrà automaticamente impostata per utilizzare l'ultima versione dell'API di produzione Square. Se si utilizza un'applicazione esistente, si consiglia di impostarla sull'ultima versione dell'API di produzione Square per motivi di sicurezza e funzionalità. Per assicurarsi che la versione dell'API di produzione della propria applicazione sia impostata sulla versione più recente, è sufficiente scorrere la parte inferiore della finestra di dialogo Credenziali pagina.

Square Versione Api 2022 06 27

Se si utilizza un applicazione esistenteSe si dispone già di un'integrazione che utilizza una versione precedente dell'API di produzione Square e si teme di interrompere l'attuale implementazione cambiando la versione dell'API, per sicurezza si consiglia di creare una nuova applicazione per l'integrazione FooSales. Facendo clic sul pulsante

Facendo clic sul pulsante Produzione si vedrà la propria scheda univoca ID applicazione e Gettone di accesso. È necessario immettere queste due chiavi nella Impostazioni del plugin FooSales WordPress.

Credenziali di produzione dell'applicazione Square

Successivamente, selezionare la voce Punto vendita API e assicurarsi di avere ancora l'opzione di menu Produzione selezionata.

Square Sandbox #

FooSales utilizza il Square Punto vendita API per inviare richieste di pagamento al vostro conto Square.

Si prega di notare: L'API del punto vendita non è attualmente supportata dall'ambiente Square Sandbox. È possibile visualizzare lo stato attuale selezionando la voce Sandbox sulla scheda Punto vendita API pagina.

Square Sandbox non supportato

Integrazione con iOS #

Per impostare l'integrazione con il file Applicazione FooSales per iPad, scorrere fino alla voce Sezione iOS sul Punto vendita API e inserire quanto segue nel campo ID bundle app iOS ingresso:

com.foosales.FooSales

Inserite quindi quanto segue nel campo Schemi URL delle app iOS ingresso:

vendite di foosales

Square Produzione di applicazioni Ios

Integrazione Android #

Per impostare l'integrazione con il file Applicazione per tablet Android FooSales, scorrere fino alla voce Sezione Android sul Punto vendita API pagina, fare clic su Aggiungi un nuovo pacchetto Android e inserire quanto segue nel campo Nome del pacchetto ingresso:

com.foosales.FooSales

Inserite quindi quanto segue nel campo Impronta digitale ingresso:

A5:54:9F:97:61:4E:D0:FE:7F:AD:12:53:3D:A9:31:D2:2A:E7:53:E6

Foosales Square Impronta digitale Android

Square Integrazione del terminale #

Se si prevede di integrare l'FooSales con un sistema Terminale Squareè necessario aggiungere il webhook FooSales all'applicazione Square. Dalla pagina Produzione fare clic sulla voce di menu "Webhooks" per espandere il relativo sottomenu. Selezionare la voce di sottomenu "Iscrizioni" per visualizzare il menu Sottoscrizioni di webhook sezione.

Square Ganci web vuoti 2022 06 27

Fare clic sul pulsante "Aggiungi abbonamento" e inserire un nome per il webhook, come ad esempio "FooSales Terminale API". Immettere l'URL del webhook per il vostro sito web Ad esempio:

[IL TUO SITO]/wp-json/foosales/v4/webhook_square

Square Nome Webhook Url 2022 06 27

Successivamente, è necessario comunicare all'Square quali eventi deve inviare all'FooSales, selezionando ogni evento pertinente.

FooSales ha bisogno di essere informato sui seguenti eventi:

  • dispositivo.codice.accoppiato
  • terminale.checkout.aggiornato
  • terminale.rimborso.aggiornato

Una volta fatto clic sul pulsante "Risparmiare", si vedrà la nuova sottoscrizione webhook aggiunta.

Square Ganci web aggiunti il 2022 06 27

FooSales WordPress Impostazioni del plugin #

Dopo aver copiato la produzione ID applicazioneGettone di accesso, navigare verso il vostro Area di amministrazione WordPress e aprire il Impostazioni del plugin FooSales. Sotto Integrazione Square, incollare il vostro ID applicazioneGettone di accesso, allora salvare le impostazioni e siete pronti a partire!

Integrazione Square Impostazioni del plugin Foosales

Accoppiamento del terminale Square #

Per processare un pagamento alla cassa utilizzando un Terminale Squareè necessario associare un dispositivo terminale all'FooSales.

Si prega di notare che questo non è necessario quando si usa l'FooSales con un Square Stand, Lettore per magstripe o Lettore per contactless e chipPoiché l'FooSales invierà semplicemente una richiesta di pagamento all'app Square Point of Sale & Payment installata sullo stesso tablet quando si utilizzano questi dispositivi.

Per accoppiare un dispositivo terminale con l'FooSales, aprire la finestra di dialogo Impostazioni FooSales e scorrere fino a Square Impostazioni. Qui è possibile selezionare la posizione Square da associare al dispositivo su cui è in esecuzione l'applicazione FooSales. Per istruzioni su come configurare più di una postazione Square, leggere il documento Gestione di più sedi con Square documentazione di aiuto.

Impostazioni Fs Square Posizione

Successivamente, è necessario accedere al Terminale utilizzando un codice dispositivo che verrà generato in FooSales. Fare clic sul pulsante "Generare il codice"per generare un nuovo codice dispositivo. Una volta generato il codice, si dovrà solo 5 minuti per accedere al terminale prima che il codice del dispositivo scada; in tal caso, sarà necessario generare un nuovo codice e tentare nuovamente il processo di accoppiamento.

Impostazioni Fs Square Codice dispositivo

Una volta immesso il codice del dispositivo e caricato il Terminale, viene visualizzato il Square Impostazioni nell'app FooSales si aggiornerà per indicare che l'accoppiamento con il dispositivo è avvenuto con successo.

Impostazioni Fs Dispositivo Square accoppiato

Dopo aver accoppiato con successo un dispositivo, l'FooSales ricorderà l'identificativo univoco del dispositivo durante l'acquisizione dei pagamenti fino a quando il dispositivo non verrà specificatamente non accoppiato. Ciò significa che è possibile associare lo stesso dispositivo a più applicazioni FooSales seguendo le istruzioni di cui sopra.

Per inserire un nuovo codice dispositivo sul Terminale Square generato da un'altra applicazione FooSales, è necessario uscire dal dispositivo accoppiato lasciando l'applicazione FooSales nella sua versione accoppiato stato. A firma in uscita dell'accoppiata Terminale Square, passare il dito sul dispositivo dall'estrema sinistra dello schermo per visualizzare il menu a scorrimento, toccare Impostazioni e poi toccare il tasto Esci che riporterà il dispositivo alla schermata di accesso. Si può quindi scegliere di effettuare nuovamente l'accesso utilizzando il nuovo codice del dispositivo.

Disaccoppiamento del terminale Square #

Se l'FooSales è accoppiato con un terminale Square specifico e si desidera accoppiarlo con un dispositivo diverso o cambiare la posizione Square che l'FooSales sta associando al dispositivo accoppiato, è necessario prima toccare il pulsante Non accoppiato per disaccoppiare il dispositivo e scegliere un'altra posizione e generare un nuovo codice dispositivo. Per firma in uscita dell'accoppiata Terminale Square, scorrere il dispositivo dall'estrema sinistra dello schermo per visualizzare il menu a scorrimento, toccare Impostazioni e poi toccare il tasto Esci che riporterà il dispositivo alla schermata di accesso. È quindi possibile effettuare nuovamente l'accesso utilizzando il codice del dispositivo appena generato.

Elaborazione dei pagamenti alla cassa con il terminale Square #

Quando si è pronti a completare un ordine su Cassa in FooSales, utilizzando un metodo di Terminale Square, selezionare Square Terminale di pagamento come metodo di pagamento.

Schermata del checkout di Foosales con il metodo di pagamento del lettore di carte con terminale Square

Quando si fa clic sul pulsante Pulsante di pagamento, una richiesta di pagamento verrà inviata al vostro account. Terminale Square. Seguire le istruzioni del terminale Square per elaborare il pagamento. L'applicazione FooSales attenderà che il pagamento sia completato correttamente.

Square Attesa di verifica del terminale

Una volta completato con successo il pagamento, FooSales invierà l'ordine al vostro database WooCommerce.

Elaborazione dei pagamenti alla cassa con il lettore Square #

Quando si è pronti a completare un ordine su Cassa nell'applicazione FooSales utilizzando una schermata Lettore Square, selezionare Square Lettore Pagamento come metodo di pagamento. Attualmente l'applicazione web FooSales supporta solo l'inserimento manuale della carta di credito e i pagamenti tramite terminale Square, per cui è necessario selezionare Square Pagamento manuale o Square Terminale di pagamento come metodo di pagamento.

Metodo di pagamento del lettore Square

Toccare il tasto Pulsante di pagamento aprirà un Schermata di pagamento Square che include il totale dell'ordine dalla schermata di checkout. A questo punto è possibile elaborare il pagamento con carta utilizzando l'hardware Square come di consueto o inserendo manualmente i dati della carta nel caso dell'applicazione web.

Scheda di processo di integrazione Square

Una volta completato con successo il pagamento, si tornerà all'applicazione FooSales e l'ordine verrà inviato e contrassegnato come Completato nel vostro negozio WooCommerce. La transazione Square sarà collegata all'ordine WooCommerce. Se si apre l'ordine completato sul sito Ordini Nella schermata di pagamento, il metodo di pagamento è evidenziato se è stato utilizzato Square per elaborare il pagamento. Toccando questo testo si aprirà la transazione Square collegata in una finestra del browser.

Se si naviga nella sezione Ordine WooCommerce nel vostro Area di amministrazione WordPress, si vedrà il metodo di pagamento contrassegnato come Square insieme a un link a Visualizza la transazione in una nuova scheda del browser.

Square Integrazione Ordine Woocommerce

Elaborazione manuale della carta alla cassa #

Se non si dispone di un dispositivo Square Reader o in caso di emergenza, è comunque possibile inserire manualmente i dati della carta del cliente alla cassa per elaborare il pagamento dell'ordine. Selezionare Square Pagamento manuale come metodo di pagamento.

Quando si fa clic sul pulsante Pulsante di pagamentoapparirà un modulo che consente di inserire il numero di carta, la data di scadenza e il CVC per elaborare il pagamento. Una volta effettuato il pagamento, FooSales completerà l'ordine e lo invierà al negozio WooCommerce.

Modulo scheda manuale Square

Rimborso di un ordine #

Se avete inserito il vostro Gettone di accesso Square nel vostro FooSales WordPress plugin e si rimborsa un ordine in FooSales, la transazione in Square verrà automaticamente rimborsata sulla carta che ha originariamente effettuato il pagamento. Se la transazione conteneva offerte suddivise o il rimborso fallito per qualche motivo sconosciuto, lo stato dell'ordine viene modificato in Rimborsato in WooCommerce e un messaggio di errore che consente di visualizzare la transazione e di rimborsare il pagamento manualmente tramite il proprio account Square.

Si prega di notare: Il rimborso di un ordine originariamente effettuato online (cioè non attraverso l'FooSales) o manualmente attraverso l'applicazione WooCommerce back-end non rimborsare automaticamente il Pagamento Square. Se desiderate rimborsare un ordine dalla vostra Area di amministrazione WordPress invece di FooSales o se si desidera rimborsare un ordine in FooSales che è stato originariamente effettuato online, è necessario fare clic sul pulsante Visualizza transazione nel link vista dell'ordine per aprire e rimborsare manualmente il pagamento attraverso il vostro Cruscotto Square e quindi impostare il parametro Stato dell'ordine WooCommerce a Rimborsato.

. Se il pagamento è stato originariamente elaborato su un conto abbinato Terminale Square e la carta originale deve essere presentata, come nel caso di una carta di debito Interac, verrà inviata una richiesta di rimborso al titolare della carta. Terminale Square e il Applicazione FooSales attenderà che il rimborso sia completato con successo.

Square Terminale di rimborso

Se il pagamento è stato originariamente elaborato utilizzando un Lettore Square nell'app iOS o Android e deve essere presentata la carta originale, ad esempio una carta di debito Interac, il rimborso dovrà essere effettuato direttamente nell'app. Punto vendita Square sulla tavoletta, non all'interno dell'applicazione FooSales.

Tag , , , , , , , , , , , , , , , , , , , , , ,