Przejdź do głównej treści
seQura

Wdrożenie Payment Provider: seQura w Odoo krok po kroku na przykładzie

Aby uruchomić Payment Provider: seQura w Odoo, dla każdego kraju kupującego uzupełniasz referencję sprzedawcy z jej Merchant ID, Assets key i ustawieniami podpisanych webhooków, a potem przeglądasz metody płatności: kategorię, kwotę minimalną i maksymalną, zakres koszyka i daty dostępności. Przechodzimy przez to na przykładzie wymyślonego sklepu, od pierwszego ekranu po to, co warto sprawdzić w pierwszym tygodniu.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 4 listopada 2026

Najważniejsze

Moduł
seQura
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
5 min

Ciclos Montseny chce przyjmować płatności przez seQura

Przykład Przypadek poglądowy: firma i jej dane są zmyślone, żeby pokazać przebieg.

Ciclos Montseny to wymyślony sklep, który sprzedaje rowery i części zamienne przez Odoo i chce zaoferować seQura kupującym z Hiszpanii. Marta, która go prowadzi, instaluje Payment Provider: seQura ze strony modułu i wykupuje plan Connector, bo połączenie przechodzi przez FlexigoTech Cloud: usługa przechowuje dane uwierzytelniające w postaci zaszyfrowanej, monitoruje synchronizację i wysyła e-mail, jeśli coś zawiedzie. Wszystko, co opisujemy dalej, Marta robi z dostawcą w trybie testowym.

Przegląd Dostawców płatności z seQura w trybie testowym: karta w widoku kanban, formularz z danymi uwierzytelniającymi, zakładka seQura accounts i zakładka metod płatności
Na danych demonstracyjnych: karta seQura z etykietami Test Mode i Published, formularz z ukrytymi danymi uwierzytelniającymi i przyciskiem Fetch merchant accounts, zakładka seQura accounts z wierszem dla Hiszpanii oraz zakładka metod płatności z wierszem part_payment i przyciskiem Refresh.

Krok pierwszy: referencja sprzedawcy dla każdego kraju

Na animacji widać zakładkę seQura accounts z wierszem dla Hiszpanii, jej Merchant ID i Assets key. Marta przegląda pola tego konta jedno po drugim:

  • Country (country_id): kraj kupującego, dla którego służy ta referencja sprzedawcy.
  • Merchant ID (merchant_ref): referencja sprzedawcy, którą seQura wydała jej dla tego kraju.
  • Assets key (assets_key): wymagają go widżety promocyjne, a seQura przekazuje go razem z danymi uwierzytelniającymi.
  • Signed webhooks (verify_signature): określa, czy seQura podpisuje zdarzenia webhook wysyłane do tego konta.
  • Signature secret (signature_secret): służy do weryfikacji, że zdarzenia webhook naprawdę pochodzą od seQura.

Ponieważ widżety promocyjne wymagają Assets key, Marta wkleja go od razu, gdy seQura prześle go z danymi uwierzytelniającymi, zamiast odkładać to na później.

Szczegół, który Marta zapisuje: Signed webhooks i Signature secret idą w parze. Pierwsze pole mówi, czy seQura podpisuje zdarzenia tego konta, drugie służy do sprawdzenia, że zdarzenie pochodzi od seQura. Marta upewnia się, że oba odpowiadają temu, co seQura wskazała dla jej konta.

Krok drugi: uważna lektura metod płatności

Na animacji zakładka metod płatności pokazuje wiersz dla Hiszpanii z kategorią part_payment. Każda metoda przechowuje poniższe pola, a Marta czyta je, zanim cokolwiek opublikuje:

  • Product (product_code) i Campaign (campaign): produkt i kampania metody.
  • Category (category): jedna z wartości pay_now, pay_later lub part_payment.
  • Title, Long title, Claim, Description i Cost description: teksty zapisane w metodzie.
  • Icon (SVG) (icon_svg): ikona metody w formacie SVG.
  • Minimum amount i Maximum amount: minimalna i maksymalna kwota metody.
  • Basket range (limits_display): wielkości koszyka, dla których można zaoferować ten produkt.
  • Available from i Available until: data początku i końca dostępności.

Są jeszcze trzy pola, które Marta znajduje, ale nie interpretuje na własną rękę: Covers services (allows_services), Contract options (contract_options) i Confirmation path (confirmation_path), w którego definicji pojawia się wartość down_payment_on_confirmation. Jeśli masz co do nich wątpliwości, zajrzyj do artykułu o tym, jak moduł działa od środka.

Krok trzeci: widżety promocyjne

Gdy konto dla Hiszpanii jest kompletne, Marta otwiera zakładkę seQura widgets, żeby zdecydować, gdzie je wyświetlać. Najpierw sprawdza, czy Assets key jest uzupełniony, bo to pole jest wymagane przez widżety promocyjne.

Formularz dostawcy seQura w trybie testowym z otwartą zakładką seQura widgets
Zakładka seQura widgets: opcje widżetów promocyjnych, produkt, wygląd w JSON oraz miejsca wyświetlania na stronie produktu, w koszyku i na listach. Na danych demonstracyjnych.

Krok czwarty: co zobaczy osoba uzgadniająca płatności

Moduł zawiera też sekcję wypłat seQura z menu operacji, finansów i konfiguracji. Marta pokazuje ją osobie prowadzącej księgowość na zrzutach z danymi demonstracyjnymi, żeby wiedziała, jakie ekrany zobaczy.

Lista wypłat seQura z jednym rekordem demonstracyjnym
Lista wypłat: data wystawienia, referencja, przelana kwota, prowizje, uzgodnione zamówienia i firma. Na danych demonstracyjnych (Wizard Phone).
Formularz wypłaty seQura z kwotami, prowizjami i tabelą pozycji rozliczenia
Formularz wypłaty z datą, przelanymi kwotami, prowizjami, dostawcą, konfiguracją i firmą oraz zakładką Settlement lines z pięcioma zamówieniami i ich sumami. Na danych demonstracyjnych.

Pierwszy tydzień: co sprawdza Marta

Gdy dostawca już działa, Marta co kilka dni rezerwuje chwilę, żeby przejrzeć:

  • Czy konto dla Hiszpanii ma poprawny Country i Merchant ID wydany przez seQura dla tego kraju.
  • Czy Assets key nadal jest uzupełniony, jeśli sklep korzysta z widżetów promocyjnych.
  • Czy Signed webhooks i Signature secret zgadzają się z tym, co seQura podaje dla konta.
  • Czy każda metoda płatności ma oczekiwaną Category, a Minimum amount, Maximum amount i Basket range pasują do tego, co sprzedaje.
  • Czy żadna metoda, którą chce oferować, nie ma już minionej daty Available until.
  • Skrzynkę e-mail: FlexigoTech Cloud wysyła e-mail, gdy synchronizacja zawiedzie, więc Marta nie filtruje tych powiadomień.

Jeśli pojawi się komunikat, którego nie rozumie, szuka go na liście komunikatów o błędach i ostrzeżeń modułu, z dosłowną treścią każdego z nich.

Czego uczy ten przykład

Wdrożenie dzieli się na dwa bloki: konto dla każdego kraju (referencja sprzedawcy, Assets key i podpisane webhooki) oraz metody płatności z kwotami, zakresem koszyka i datami. Gdy pierwszy blok jest kompletny, drugi sprowadza się do spokojnego przeczytania każdego pola.

Warto też wiedzieć, co dzieje się z subskrypcją: bez niej albo przy zawieszonej usłudze przestaje działać to, co zapewnia subskrypcja, ale dane zostają w Twoim Odoo. A jeśli seQura zmieni swoje API, moduł i usługa zostaną dostosowane.

Jak pomaga FlexigoTech

Payment Provider: seQura jest opublikowany w Odoo Apps dla Odoo 17, 18, 19 i 20 w cenie 9 € za wersję Odoo (płatność jednorazowa, netto (bez VAT)), a połączenie działa w planie Connector FlexigoTech Cloud: 49 €/mies. lub 490 €/rok netto (bez VAT), z maksymalnie 3 kontami platformy. W ramach subskrypcji moduł dla nowych wersji Odoo jest wliczony, jeśli kupiłeś go na flexigotech.com; w Odoo App Store każdą wersję kupuje się tam. Szczegóły znajdziesz na karcie w Odoo Apps.

Jeśli dopiero wdrażasz Odoo, FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie, więc możemy skonfigurować seQura w ramach projektu.

Czytaj dalej

Jak działa Payment Provider: seQura w Odoo: menu, zaplanowane akcje i rekordyJakie menu dodaje Payment Provider: seQura do Odoo, jakie zaplanowane akcje działają codziennie lub co tydzień i gdzie widzisz zamówienia, płatności i rozliczenia.Błędy Payment Provider: seQura w Odoo: przykład od początku do końcaKomunikaty błędów Payment Provider: seQura w Odoo w dosłownym brzmieniu: kiedy się pojawiają i co zrobić, omówione na przykładowym przypadku sklepu.Przyjmujesz płatności przez seQura, ale nie używasz Odoo: sześć mitów o konektorzePrzyjmujesz płatności przez seQura, ale nie masz Odoo? Czego wymaga konektor Payment Provider: seQura, co obejmuje subskrypcja i od czego zacząć wdrożenie.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła