1. Tematy
  2. Płatności
  3. Integracja płatności Square

Integracja płatności Square

 

FooSales integruje się ze sprzętem Square w celu przechwytywania płatności kartą bezpośrednio w aplikacjach FooSales, zapewniając płynną realizację transakcji. Nie ma potrzeby synchronizowania katalogów produktów między sklepem WooCommerce a kontem Square. Sumy zamówień są wysyłane do Square przy kasie, a po pomyślnym zakończeniu płatności, FooSales automatycznie uzupełnia zamówienie WooCommerce.

Uwaga: Dodatek FooSales Square Payments jest wymagany do integracji Square, która jest dostępna jako opcjonalny dodatek przy zakupie urządzenia. Plan dla jednej lub wielu domen i jest również dostępny osobno jeśli chcesz dodać go do istniejącego planu.

Wymagania #

Do integracji płatności Square wymagane są następujące elementy:

Konfiguracja #

Jeśli planujesz zintegrować FooSales z aplikacją Stojak Square, Czytnik paska magnetycznego lub Czytnik zbliżeniowy i chipowyupewnij się, że posiadasz Square Punkt sprzedaży i płatności zainstalowanej na iPadzie lub tablecie z systemem Android, który będzie używany w aplikacji FooSales.

Po pobraniu i zainstalowaniu aplikacji Square Punkt sprzedaży i płatności na tablecie, zaloguj się do aplikacji przy użyciu swojego Konto Square nazwa użytkownika i hasło.

Aby aplikacje FooSales i Square Point of Sale mogły się ze sobą komunikować, należy utworzyć nowy lub zaktualizować istniejący Square w aplikacji Pulpit programisty Square.

Utwórz nową aplikację Square #

Otwórz Pulpit programisty Square i wybrać Nowa aplikacja, Utwórz swoją pierwszą aplikację jeśli jest to nowe konto LUB Otwarty wcześniej utworzonej aplikacji, jeśli taka już istnieje na koncie użytkownika.

Square Developer Dashboard Tworzenie aplikacji

Podczas tworzenia nowa aplikacjakonieczne będzie wprowadzenie nazwa aplikacji i zgodzić się na Warunki korzystania z usługi Square Developer.

. Następnie otwórz nowo utworzoną lub istniejącą aplikację. Jeśli utworzyłeś nową aplikację, zostanie ona automatycznie ustawiona na korzystanie z najnowszej wersji produkcyjnego interfejsu API Square. Jeśli korzystasz z istniejącej aplikacji, zaleca się ustawienie jej na korzystanie z najnowszej wersji produkcyjnego interfejsu API Square ze względów bezpieczeństwa i funkcjonalności. Możesz upewnić się, że wersja produkcyjnego interfejsu API aplikacji jest ustawiona na najnowszą wersję, przewijając do dołu strony Poświadczenia strona.

Square Api Version 2022 06 27

Jeśli używasz istniejąca aplikacjaJeśli masz już skonfigurowaną integrację przy użyciu starszej wersji produkcyjnego interfejsu API Square i obawiasz się zepsucia bieżącej implementacji poprzez zmianę wersji interfejsu API, to dla bezpieczeństwa sugerujemy raczej utworzenie nowej aplikacji dla integracji FooSales. Klikając na przycisk

Klikając przycisk Produkcja zakładce, zobaczysz swój unikalny Identyfikator aplikacji oraz Token dostępu. Konieczne będzie wprowadzenie tych dwóch kluczy w aplikacji Ustawienia wtyczki FooSales WordPress.

Poświadczenia produkcyjne aplikacji Square

Następnie wybierz API punktu sprzedaży opcję menu i upewnij się, że nadal masz Produkcja wybrana karta.

Square Sandbox #

FooSales wykorzystuje Square API punktu sprzedaży w celu wysyłania żądań płatności na konto Square.

Uwaga: Interfejs API punktu sprzedaży nie jest obecnie obsługiwany przez środowisko Square Sandbox. Aktualny status można wyświetlić, wybierając opcję Piaskownica na karcie API punktu sprzedaży strona.

Square Sandbox nie jest obsługiwany

Integracja z systemem iOS #

Aby skonfigurować integrację z Aplikacja FooSales na iPada, przewiń w dół do Sekcja iOS na API punktu sprzedaży i wprowadź następujące dane w polu Identyfikatory pakietów aplikacji iOS wkład:

com.foosales.FooSales

Następnie wprowadź następujące dane w polu Schematy URL aplikacji iOS wkład:

foosales

Square Produkcja aplikacji Ios

Integracja z systemem Android #

Aby skonfigurować integrację z Aplikacja FooSales na tablet z systemem Android, przewiń w dół do Sekcja Android na API punktu sprzedaży kliknij Dodaj nowy pakiet Android i wprowadź następujące dane w polu Nazwa pakietu wkład:

com.foosales.FooSales

Następnie wprowadź następujące dane w polu Odcisk palca wkład:

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

Odcisk palca Foosales Square Android

Integracja terminala Square #

Jeśli planujesz zintegrować FooSales z aplikacją Terminal Square, należy dodać webhook FooSales do aplikacji Square. Z poziomu Produkcja kliknij pozycję menu "Webhooks", aby rozwinąć jej podmenu. Wybierz pozycję podmenu "Subskrypcje", aby wyświetlić sekcję Subskrypcje webhooków sekcja.

Square Webhooks Empty 2022 06 27

Kliknij na "Dodaj subskrypcję" i wprowadź nazwę webhooka, taką jak "FooSales Terminal API". Wprowadź adres URL webhook dla witryna np:

[TWOJA STRONA]/wp-json/foosales/v4/webhook_square

Square Webhook Name Url 2022 06 27

Następnie należy poinformować Square, które zdarzenia ma wysłać do FooSales, zaznaczając każde odpowiednie zdarzenie.

FooSales musi zostać powiadomiony o następujących wydarzeniach:

  • device.code.paired
  • terminal.checkout.updated
  • terminal.refund.updated

Po kliknięciu przycisku "Zapisz", zobaczysz nowo dodaną subskrypcję webhook.

Square Webhooks Dodano 2022 06 27

Ustawienia wtyczki FooSales WordPress #

Po skopiowaniu produkcji Identyfikator aplikacji oraz Token dostępu, przejdź do Obszar administracyjny WordPress i otworzyć Ustawienia wtyczki FooSales. Pod Integracja Squarewklej swój Identyfikator aplikacji oraz Token dostępuwtedy Zapisz ustawienia i gotowe!

Ustawienia wtyczki Square Integration Foosales

Parowanie terminala Square #

Aby przetworzyć płatność przy kasie przy użyciu Terminal Square, konieczne będzie sparowanie urządzenia Terminal z FooSales.

Uwaga że nie jest to konieczne w przypadku korzystania z FooSales z Stojak Square, Czytnik paska magnetycznego lub Czytnik zbliżeniowy i chipowyPonieważ FooSales po prostu wyśle żądanie płatności do aplikacji Square Point of Sale & Payment zainstalowanej na tym samym tablecie podczas korzystania z tych urządzeń.

Aby sparować urządzenie Terminal z FooSales, otwórz aplikację Ustawienia FooSales i przewiń w dół do Ustawienia Square. W tym miejscu można wybrać lokalizację Square, która ma być powiązana z urządzeniem, na którym uruchomiona jest aplikacja FooSales. Aby uzyskać instrukcje dotyczące konfigurowania więcej niż jednej lokalizacji Square, zapoznaj się z sekcją Zarządzanie wieloma lokalizacjami za pomocą Square dokumentacja pomocy.

Ustawienia Fs Square Lokalizacja

Następnie należy zalogować się do terminala za pomocą polecenia kod urządzenia który zostanie wygenerowany w FooSales. Kliknij na "Generowanie kodu", aby wygenerować nowy kod urządzenia. Po wygenerowaniu kodu będziesz musiał jedynie 5 minut aby zalogować się do terminala przed wygaśnięciem kodu urządzenia, w takim przypadku konieczne będzie wygenerowanie nowego kodu i ponowna próba sparowania.

Ustawienia Fs Kod urządzenia Square

Po wprowadzeniu kodu urządzenia i załadowaniu terminala, aplikacja Ustawienia Square w aplikacji FooSales zostanie zaktualizowana, aby pokazać, że została pomyślnie sparowana z urządzeniem.

Ustawienia Fs Sparowane urządzenie Square

Po pomyślnym sparowaniu urządzenia, FooSales zapamięta unikalny identyfikator urządzenia podczas przechwytywania płatności, dopóki urządzenie nie zostanie specjalnie sparowane. niesparowany. Oznacza to, że można sparować to samo urządzenie z wieloma aplikacjami FooSales, postępując zgodnie z powyższymi instrukcjami.

Aby wprowadzić nowy kod urządzenia na terminalu Square, który został wygenerowany przez inną aplikację FooSales, należy wylogować się ze sparowanego urządzenia, pozostawiając aplikację FooSales w jej aplikacji. sparowany stan. Do wylogowanie sparowanych Terminal Square, przesuń palcem po urządzeniu od lewej strony ekranu, aby wyświetlić wysuwane menu, stuknij ikonę Ustawienia a następnie dotknij przycisku Wyloguj się co spowoduje powrót urządzenia do ekranu logowania. Następnie można ponownie zalogować się przy użyciu nowego kodu urządzenia.

Odparowanie terminala Square #

Jeśli FooSales jest sparowany z określonym terminalem Square i chcesz sparować go z innym urządzeniem lub zmienić lokalizację Square, którą FooSales kojarzy ze sparowanym urządzeniem, musisz najpierw dotknąć przycisku Unpair aby rozłączyć urządzenie w celu wybrania innej lokalizacji i wygenerowania nowego kodu urządzenia. Do wylogowanie sparowanych Terminal Square, przesuń palcem po urządzeniu od lewej strony ekranu, aby wyświetlić wysuwane menu, stuknij ikonę Ustawienia a następnie dotknij przycisku Wyloguj się co spowoduje powrót urządzenia do ekranu logowania. Następnie można zalogować się ponownie przy użyciu nowo wygenerowanego kodu urządzenia.

Przetwarzanie płatności przy kasie przy użyciu terminala Square #

Gdy będziesz gotowy do złożenia zamówienia na Kasa ekran w FooSales przy użyciu sparowanego Terminal Square, wybierz Terminal płatniczy Square jako metoda płatności.

Zrzut ekranu z kasy Foosales przy użyciu metody płatności czytnika kart terminala Square

Po kliknięciu przycisku Przycisk płatnościżądanie realizacji transakcji zostanie wysłane do sparowanego użytkownika Terminal Square. Postępuj zgodnie z instrukcjami wyświetlanymi na terminalu Square, aby przetworzyć płatność. Aplikacja FooSales będzie czekać na pomyślne zakończenie płatności.

Square Terminal Checkout Wait

Po pomyślnym zakończeniu płatności, FooSales prześle zamówienie do bazy danych WooCommerce.

Przetwarzanie płatności przy kasie przy użyciu czytnika Square #

Gdy będziesz gotowy do złożenia zamówienia na Kasa ekran w aplikacji FooSales przy użyciu aplikacji Czytnik Square, wybierz Płatność czytnikiem Square jako metodę płatności. Aplikacja internetowa FooSales obsługuje obecnie tylko ręczne wprowadzanie danych kart kredytowych i płatności za pomocą terminala Square, więc należy wybrać opcję Square Płatność ręczna lub Terminal płatniczy Square jako metoda płatności.

Czytnik Square Metoda płatności

Stuknięcie przycisku Przycisk płatności otworzy plik Ekran płatności Square która zawiera sumę zamówienia z ekranu kasy. Możesz teraz przetworzyć płatność kartą za pomocą sprzętu Square w zwykły sposób lub ręcznie wprowadzić dane karty w przypadku aplikacji internetowej.

Karta procesu integracji Square

Po pomyślnym zakończeniu płatności nastąpi powrót do aplikacji FooSales, a zamówienie zostanie przesłane i oznaczone jako Zakończono w sklepie WooCommerce. Transakcja Square zostanie powiązana z zamówieniem WooCommerce. Jeśli otworzysz zrealizowane zamówienie na stronie Zamówienia zobaczysz podświetloną metodę płatności, jeśli do przetworzenia płatności użyto Square. Dotknięcie tego tekstu spowoduje otwarcie powiązanej transakcji Square w oknie przeglądarki dla wygody użytkownika.

Jeśli przejdziesz do WooCommerce Zamówienie w swoim Obszar administracyjny WordPresszobaczysz metodę płatności oznaczoną jako Square wraz z linkiem do Wyświetl transakcję w nowej karcie przeglądarki.

Square Integracja Woocommerce Order

Ręczne przetwarzanie kart przy kasie #

Jeśli nie posiadasz urządzenia Square Reader lub w sytuacji awaryjnej, nadal możesz ręcznie wprowadzić dane karty klienta przy kasie, aby przetworzyć płatność za zamówienie. Wybierz Square Płatność ręczna jako metoda płatności.

Po kliknięciu przycisku Przycisk płatnościPojawi się formularz umożliwiający wprowadzenie numeru karty, daty ważności i CVC w celu przetworzenia płatności. Po pomyślnym przesłaniu płatności FooSales sfinalizuje zamówienie i prześle je do sklepu WooCommerce.

Formularz karty instrukcji Square

Zwrot kosztów zamówienia #

Jeśli wprowadziłeś swój Token dostępu Square w swoim Wtyczka FooSales WordPress i dokonasz zwrotu zamówienia w FooSales, transakcja Square zostanie automatycznie zwrócona na kartę, którą pierwotnie dokonano płatności. Jeśli transakcja zawierała przetargi dzielone lub zwrot nie powiódł się z nieznanego powodu status zamówienia został zmieniony na Zwrócone w WooCommerce i komunikat o błędzie która umożliwia wyświetlenie transakcji i ręczny zwrot płatności za pośrednictwem konta Square.

Uwaga: Zwrot kosztów zamówienia, które zostało pierwotnie złożone online (tj. nie za pośrednictwem FooSales) lub ręcznie za pośrednictwem WooCommerce back-end nie będzie automatycznie zwróci Płatność Square. Jeśli chcesz zwrócić pieniądze za zamówienie z konta Obszar administracyjny WordPress zamiast FooSales Jeśli chcesz dokonać zwrotu pieniędzy za zamówienie w FooSales, które zostało złożone online, kliknij przycisk Wyświetl transakcję link w widok zamówienia aby otworzyć i ręcznie zwrócić płatność za pośrednictwem aplikacji Square Dashboard a następnie ustawić Status zamówienia WooCommerce do Zwrócone.

. Jeśli płatność została pierwotnie przetworzona za pomocą sparowanego Terminal Square w przypadku konieczności okazania oryginalnej karty, np. karty debetowej Interac, prośba o zwrot pieniędzy zostanie wysłana do sparowanej osoby. Terminal Square i Aplikacja FooSales będzie czekać, aż zwrot zostanie pomyślnie zakończony.

Square Terminal Refund

Jeśli płatność została pierwotnie przetworzona przy użyciu Czytnik Square w aplikacji na iOS lub Androida i konieczne jest okazanie oryginalnej karty, np. karty debetowej Interac, zwrot będzie musiał zostać dokonany bezpośrednio w aplikacji na iOS lub Androida. Square Punkt sprzedaży na tablecie, a nie w aplikacji FooSales.

Tagi , , , , , , , , , , , , , , , , , , , , , ,