Jak skonfigurować niestandardową bramkę płatności

Przewodnik dla programistów dotyczący integracji niestandardowej bramki płatności z Tilda
Tilda jest zintegrowana z popularnymi systemami płatności, takimi jak Stripe, PayPal i 2Checkout. Oto jak zintegrować niestandardowy system płatności ze swoją witryną za pomocą niestandardowej bramki płatności.
Wszystkie zatwierdzone i przetestowane szablony integracji są dostępne na publicznej liście szablonów. Wszystkie integracje zostały stworzone przez twórców systemów płatności. Po wybraniu szablonu można znaleźć link do dokumentacji systemu płatności i adres e-mail programistów w przypadku pytań dotyczących integracji. Tilda Pomoc techniczna nie będzie w stanie odpowiedzieć na żadne pytania dotyczące integracji innych firm.
Aby skonfigurować pełną integrację z niestandardową bramką płatności, przejdź do Ustawienia witryny → Systemy płatności i wybierz "Niestandardowa bramka płatności".
Ważne: Jeśli wśród szablonów rozwiązań płatniczych nie ma szablonu, który Ci odpowiada, skontaktuj się z zespołem programistów systemu płatności i wyślij im link do tego przewodnika. Utworzenie nowego szablonu wymaga udziału deweloperów.
Można wybrać szablon integracji lub utworzyć szablon niestandardowy.

Szablony to gotowe zestawy parametrów do integracji określonego systemu. Mogą one zawierać niezmienne ustawienia, takie jak adres URL API lub pole numeru zamówienia, a także zmienne ustawienia ("Ustawienia zaawansowane").

Jeśli wśród opcji widzisz szablon dla swojego rozwiązania płatniczego, oznacza to, że programiści skontaktowali się z nami, dzięki czemu możesz łatwo skonfigurować integrację ze swoim systemem płatności.
Należy pamiętać, że Tilda Publishing nie ponosi odpowiedzialności za działanie i bezpieczeństwo integracji systemów płatności stron trzecich.

Przeczytaj oficjalne wyłączenieodpowiedzialności →
Jeśli Twojego systemu płatności nie ma na liście, musisz skontaktować się z twórcami rozwiązania płatniczego, aby poprosili o jego utworzenie.

Aby rozpocząć procedurę, musisz podać nazwę i adres URL systemu płatności, do którego użytkownik powinien zostać przekierowany za pomocą żądania POST w celu dokonania płatności, kontaktowy adres e-mail oraz wszelkie dodatkowe informacje, które mogą pomóc w integracji, takie jak linki do dokumentacji systemu płatności.
Ważne: Tworzenie nowego szablonu wymaga dogłębnej wiedzy na temat integracji i programowania bramek płatności. Aby utworzyć szablon, musisz być programistą rozwiązań płatniczych lub mieć dogłębną wiedzę na temat szczegółów integracji.
Gdy tylko zespół moderatorów zatwierdzi szablon, stanie się on dostępny na liście dla konkretnego projektu. Następnie można zmodyfikować dodatkowe ustawienia, zmienić nazwy zmiennych przekazywanych wraz z zamówieniami klientów i debugować integrację.

Najpierw należy określić nazwy wszystkich krytycznych i wymaganych pól, których dane powinny być przekazywane wraz z zamówieniami klientów, a także zmodyfikować dodatkowe ustawienia, takie jak wielkość liter, format i długość pola.
Po skonfigurowaniu wymaganych pól może być konieczne określenie innych zmiennych przekazywanych podczas tworzenia zamówienia. Można je dodać w sekcji "Lista dodatkowych pól". Liczba elementów listy zależy od potrzeb integracji.
Należy również skonfigurować podpis zamówienia i określić zasady jego tworzenia (wykluczone pola, zasada sortowania, separator i algorytm szyfrowania).

Najpierw należy wybrać zasady podpisu lub wybrać opcję "Wszystkie pola" i określić wykluczone pola, zasadę sortowania i separator. Jeśli potrzebujesz niestandardowego formatu danych, wybierz "Reguły specjalne" i ustaw reguły formatu niestandardowego.
Następnie należy skonfigurować wskaźnik udanej płatności (nazwa i wartość parametru) oraz określić, co system powinien zwracać w odpowiedzi na udane lub odrzucone płatności.
Format interakcji
1. Kupujący dodaje produkt do koszyka, wypełnia formularz i klika Checkout.

2. Tilda otrzymuje żądanie zapisania nowego zamówienia i zwraca zestaw parametrów, które zostaną uwzględnione w żądaniu dla systemu płatności zgodnie z listą pól mapowania i listą pól dodatkowych z zaawansowanych ustawień integracji.
Ważne: Wśród parametrów zawsze musi znajdować się pole zawierające podpis zamówienia. Podpis jest generowany na podstawie wartości innych pól przy użyciu określonego algorytmu i klucza płatności. Algorytm ten można skonfigurować w sekcji "Podpis zamówienia" w zaawansowanych ustawieniach integracji.
Użytkownik zostaje przekierowany do adresu URL API szablonu. Parametry są przesyłane przy użyciu metody POST.

System płatności przetwarza parametry i, jeśli podpis jest poprawny, wyświetla formularz płatności, przetwarza płatność i komunikuje się z innymi systemami, jeśli to konieczne.

System płatności może przekierować użytkownika na stronę powodzenia po udanej płatności (jeśli określono w ustawieniach) lub wysłać powiadomienie.

System płatności musi również wysłać żądanie do adresu URL powiadomienia - dedykowanego adresu URL serwera Tilda . Żądanie to musi również przesyłać parametry i podpis przy użyciu metody POST (algorytmy podpisu mogą się różnić). W ustawieniach zaawansowanych należy również dodać pole (i określić jego wartość) używane do weryfikacji statusu płatności - będzie to wskaźnik pomyślnej płatności.

Zamówienie zostanie oznaczone jako opłacone na stronie Tilda dopiero po wysłaniu żądania z prawidłowym podpisem, numerem zamówienia, kwotą i wskaźnikiem pomyślnej płatności na adres URL powiadomienia.
Jak dostosować pola
Aby ułatwić użytkownikom zrozumienie, którym polom Tilda odpowiadają pola systemu płatności, udostępniamy opcję zmiany nazw niektórych pól i podpowiedzi w sekcji "Ustawienia formularza" w ustawieniach zaawansowanych.
Jak debugować integrację
Aby debugować integrację, utwórz stronę i skonfiguruj ją zgodnie z przewodnikiem Jak skonfigurować koszyk: Dodaj koszyk i blok produktu do strony i opublikuj ją.

Sugerujemy dokonanie płatności testowej i sprawdzenie, czy płatność zostanie zrealizowana. Jeśli wszystko jest w porządku, skontaktuj się z zespołem moderatorów, a Twój szablon zostanie dodany do listy publicznej.
Wykonane na
Tilda