Integracja ZEN z SalesCRM

Podłącz ZEN, aby klienci płacili kartą, BLIK-iem, Apple Pay, Google Pay albo szybkim przelewem na jednej stronie płatności.

1. Co daje integracja?

Po podłączeniu w koszyku pojawia się metoda ZEN z logo ZEN.COM. Klient przechodzi na stronę płatności ZEN i sam wybiera, czym zapłaci: Apple Pay, Google Pay, kartą, BLIK-iem, szybkim przelewem z banku, portfelem Skrill albo aplikacją ZEN. Lista metod zależy od kraju klienta i ustawień Twojego konta w ZEN. Gdy płatność dojdzie, zamówienie samo zmienia status na opłacone.

2. Czego potrzebujesz

Konto firmowe w ZEN.COM z uruchomionym terminalem do płatności online. Z ustawień terminala pobierz trzy wartości:

• Terminal UUID - identyfikator terminala w formacie xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,
• Paywall Secret - podpisuje zlecenie płatności wysyłane z Twojego sklepu,
• IPN Secret - sprawdza powiadomienie o płatności, żeby nikt nie mógł podszyć się pod potwierdzenie.

Chcesz, żeby klient wpisywał kod BLIK od razu w koszyku? Pobierz też czwartą wartość, Terminal API key. Opis w punkcie BLIK kodem w koszyku.

Oba sekrety traktuj jak hasła. Adresu powiadomień nie ustawiasz w ZEN ręcznie, SalesCRM przekazuje go przy każdej płatności.

3. Konfiguracja

1. W panelu SalesCRM wejdź w Integracje, sekcja Płatności, i przy Szybkie płatności ZEN kliknij edycję.
2. Wklej Terminal UUID, Paywall Secret i IPN Secret, potem zapisz.
3. Wejdź w Konfiguracja → Rodzaje płatności i włącz metodę ZEN. Sam zapis danych jej nie włącza.

4. Weryfikacja

Najpewniejszy test to realne zamówienie na niską kwotę, np. 1 zł, opłacone BLIK-iem. Sprawdź dwie rzeczy: czy klient wrócił do sklepu po płatności i czy zamówienie w panelu samo zmieniło status na opłacone. Jeśli pieniądze doszły, a status się nie zmienił, przyczyną jest zwykle błędny IPN Secret. Jeśli strona płatności ZEN w ogóle się nie otwiera, sprawdź Terminal UUID i Paywall Secret.

5. Przyciski Apple Pay i Google Pay

Gdy ZEN jest aktywny, nad listą płatności w koszyku pojawia się czarny przycisk portfela. Na iPhonie, iPadzie i w Safari na Macu to Apple Pay, na pozostałych urządzeniach Google Pay. Klik składa zamówienie i otwiera stronę ZEN od razu z wybranym portfelem, bez listy innych metod. Kafelek ZEN zostaje na liście jak dotąd.

Przyciski działają, jeśli Apple Pay i Google Pay są włączone w Twoim terminalu ZEN.

Masz też Tpay? Przyciski portfeli pokazuje tylko jedna bramka. Wybierzesz ją w Wygląd koszyka → Bramka Apple Pay / Google Pay. Pole widać, gdy aktywne są obie bramki. Dopóki nic nie wybierzesz, przyciski idą przez Tpay. Druga bramka zostaje w koszyku jako zwykła metoda płatności.

6. BLIK kodem w koszyku

Klient może zapłacić BLIK-iem bez przechodzenia na stronę ZEN. Wybiera w koszyku ZEN, wpisuje 6-cyfrowy kod z aplikacji banku i klika Zamów i zapłać. Potem potwierdza płatność w telefonie, a koszyk sam przenosi go na stronę podziękowania. Kto nie wpisze kodu, przechodzi na stronę płatności ZEN jak dotąd.

Kod BLIK idzie przez API ZEN, więc potrzebny jest osobny klucz:

1. W my.zen.com wejdź w ustawienia terminala i skopiuj Terminal API key.
2. W SalesCRM, w Integracje → Szybkie płatności ZEN, wklej go w pole Terminal API key (opcjonalnie) i zapisz.
3. W Wygląd koszyka zaznacz BLIK inline (płatność kodem w koszyku). Opcja jest dostępna w układzie Koszyk Imker v2.
4. Masz też Tpay, PayU albo Paynow z BLIK-iem w koszyku? W polu Bramka BLIK inline wybierz ZEN. Kod obsługuje tylko jedna bramka naraz.

Integracja API i BLIK muszą być aktywne na Twoim terminalu w ZEN. Bez tego płatność kodem nie zadziała. Jeśli nie masz pewności, zapytaj obsługę ZEN, zanim włączysz opcję. Po włączeniu zrób zamówienie testowe za 1-2 zł z kodem BLIK.

Gdy kod wygaśnie, zanim klient go potwierdzi, koszyk pokaże przycisk Zapłać inaczej. Prowadzi on na zwykłą stronę płatności ZEN dla tego samego zamówienia.

7. Link do płatności

Link do strony płatności ZEN znajdziesz w szczegółach zamówienia. W mailach statusu wstawisz go znacznikiem {{LINK_DO_PLATNOSCI}}, np. w przypomnieniu o nieopłaconym zamówieniu.