Płatności i sklepy

Do czego: jednorazowe płatności i subskrypcje, na stronie kasy hostowanej przez Stripe. Kupujący nigdy nie wpisują numeru karty w twojej aplikacji.

Łączy się przez: przycisk Set up Stripe. Wypełniasz formularz Stripe i wracasz, a żaden klucz nie jest ci pokazywany. Najpierw opublikuj aplikację, bo Stripe patrzy na działającą stronę i odrzuca tę, która jest jeszcze w budowie. Prosi o dokument tożsamości i konto bankowe. Zamiast tego możesz użyć kluczy: klucza publikowalnego (zaczyna się od pk_) i klucza tajnego (zaczyna się od sk_) z twoich kluczy API Stripe oraz sekretu podpisu webhooka (zaczyna się od whsec_).

Tylko przy wklejonych kluczach: karta Stripe pokazuje adres webhooka, który dodajesz w Stripe, z przyciskiem kopiowania. Dodaj go dla zdarzeń checkout.session.completed i checkout.session.async_payment_succeeded. Przy przycisku nie ma webhooka do ustawienia.

Poproś o:

• „Dodaj przycisk Buy now dla kursu”
• „Dodaj plan miesięczny i przycisk Manage billing”
• „Dodaj stronę My orders”

Co się dzieje: zamówienia są zapisywane, gdy Stripe potwierdzi, że płatność przeszła, i pojawiają się w Manage, potem Payments. Zobacz Sklepy internetowe.

Ograniczenia: aplikacja może rozpocząć kasę, odczytać ją z powrotem i odczytać twój cennik. Zwroty pieniędzy, klienci i wypłaty nie są dostępne z poziomu aplikacji. Zwrotu dokonasz w Manage, potem Payments, albo w Stripe. Manage billing działa tylko dla zalogowanej osoby, która coś kupiła w tej aplikacji.

Do czego: płatności i subskrypcje, w których Paddle sprzedaje jako sprzedawca, więc VAT i podatek od sprzedaży są obsługiwane za ciebie. Warto, gdy sprzedajesz za granicę.

Łączy się przez: klucze, ze strony uwierzytelniania Paddle.

• Client-side Token (zaczyna się od live_, a w sandboksie od test_). Z założenia publiczny, więc jest wbudowany w opublikowaną aplikację.
• API Key (zaczyna się od pdl_live_apikey_ lub pdl_test_apikey_). Zostaje na serwerach Setherion.
• Webhook Secret (zaczyna się od pdl_ntfset_). Opcjonalny.

Poproś o:

• „Dodaj plan Pro z przyciskiem Subscribe, który otwiera kasę Paddle”
• „Pokaż cenę i to, co zawiera, zanim otworzy się kasa”

Jak to działa: kasa otwiera się w osobnej nakładce Paddle w przeglądarce odwiedzającego. Ceny tworzysz w panelu Paddle, a aplikacja używa ich po identyfikatorze pri_. Strona nigdy nie wysyła kwoty, bo każdy, kto ją otworzy, może ją zmienić.

Ograniczenia: opublikowana aplikacja nie używa klucza API, bo nie ma serwera. Token zaczynający się od test_ działa tylko z sandboksem Paddle. Test connection odczytuje jeden produkt z twojego konta Paddle.

Do czego: przycisk Buy dla jednego towaru w stałej cenie. Cena, podatek i wysyłka są w PayPal, więc nikt, kto otworzy stronę, nie może zmienić kwoty do zapłaty. Kupujący płacą w oknie PayPal, przez PayPal lub kartą.

Łączy się przez: dwie wartości.

• Client ID: w PayPal otwórz Pay links and buttons, potem przycisk, potem jego kod. To wartość po client-id=. Z założenia publiczna.
• Currency: trzy litery, jak GBP lub EUR, takie same jak na twoich przyciskach w PayPal.

Najpierw utwórz swoje przyciski na stronie przycisków PayPal.

Poproś o:

• „Dodaj przycisk PayPal Buy dla każdego z trzech wydruków”
• „Umieść przycisk PayPal pod ceną na stronie produktu”

Ograniczenia: każdy przycisk kupuje jeden towar w cenie ustawionej w PayPal. Nie ma koszyka. Twoja aplikacja nie dowiaduje się, że ktoś zapłacił: PayPal wysyła e-mail tobie i kupującemu, a sprzedaż nie jest zapisywana w aplikacji. Jeśli potrzebujesz koszyka, zamówień przechowywanych w aplikacji lub subskrypcji, połącz zamiast tego Stripe lub Paddle. Strona konektora mówi to samo.

Do czego: rozliczanie subskrypcji. Przycisk Subscribe otwiera kasę hostowaną przez Chargebee, przycisk Manage billing otwiera portal klienta, a twój zespół widzi klientów, subskrypcje i faktury.

Łączy się przez: klucze.

• Site name: część przed .chargebee.com w adresie twojego panelu, małymi literami.
• API key: w Chargebee otwórz Settings, potem Configure Chargebee, potem API Keys, potem Add API Key. Wybierz Write Key (tworzenie, odczyt i aktualizacja, nigdy usuwanie). To wszystko, czego potrzebuje aplikacja.

Poproś o:

• „Dodaj stronę z cennikiem na podstawie moich planów Chargebee, z przyciskiem Subscribe przy każdym”
• „Dodaj przycisk Manage billing dla zalogowanych klientów”
• „Zrób stronę zespołu z moimi subskrypcjami i niezapłaconymi fakturami”

Kto co może: odwiedzający mogą rozpocząć kasę, otworzyć portal rozliczeń i odczytać plany oraz ceny w sprzedaży, na stronę z cennikiem. Klienci, subskrypcje i faktury oraz zmiana planów i cen są tylko dla twojego zespołu. Zaznacz konta, które należą do twojego zespołu, w Manage, potem Cloud, potem Users.

Ograniczenia: używa Chargebee Product Catalog 2.0, więc plany są cenami towarów. Kwoty przychodzą w pensach lub centach. Usuwanie nie jest możliwe z poziomu aplikacji. W Permissions możesz wyłączyć kasę, portal albo odczyt i zmianę klientów, subskrypcji, faktur, planów i cen, każde osobno.

Do czego: nowa witryna sklepowa na sklepie Shopify. Produkty, ceny i stany magazynowe zostają w Shopify, a kupujący płacą na stronie kasy Shopify.

Łączy się przez: dwie wartości.

• Store domain: adres .myshopify.com, nawet jeśli twój sklep pokazuje klientom własną domenę.
• Storefront API token (public): w panelu administracyjnym Shopify otwórz Sales channels, potem Headless, potem Create storefront. Skopiuj jego publiczny token dostępu.

Nigdy nie używaj tokenu Admin API (zaczyna się od shpat_): karta go odrzuca, bo ten token jest wbudowany w opublikowaną aplikację i każdy może go odczytać.

Poproś o:

• „Nową witrynę sklepową dla mojego sklepu Shopify, z kolekcjami na stronie głównej”
• „Dodaj koszyk, który przenosi kupujących do kasy Shopify”
• „Dodaj wyszukiwanie i filtry na moich produktach z Shopify”

Uprawnienia: Shopify jest inne. Twoje aplikacje wywołują je prosto ze strony za pomocą publicznego tokenu, więc w Setherion nie ma przełączników. Limity ustawiasz w Shopify: Sales channels, Headless, twoja witryna, potem Manage obok Storefront API, potem Permissions. Dotyczą każdej witryny w kanale Headless.

Ograniczenia: stany magazynowe, zamówienia i płatności zostają w Shopify. Jeśli towaru nie ma na stanie, aplikacja mówi, co się zmieniło, zanim prześle kupującego dalej.

Do czego: witryna sklepowa, która pokazuje twoje prawdziwe produkty z WooCommerce i przenosi kupujących do twojej własnej kasy.

Łączy się przez: klucze.

• Shop address: adres, pod którym działa twój sklep, ten, za którym stoi /wp-admin.
• Consumer key (zaczyna się od ck_) i Consumer secret (zaczyna się od cs_): w WooCommerce otwórz Settings, potem Advanced, potem REST API, potem Add key, z ustawionym Permissions na Read.

Oba klucze zostają na serwerach Setherion.

Poproś o:

• „Pokaż moje produkty z WooCommerce w siatce, z przyciskiem Buy przy każdym”
• „Dodaj stronę dla każdego produktu z jego zdjęciami i ceną”

Ograniczenia: produkty to jedyna rzecz, którą aplikacja może odczytać. Zamówienia i klienci są odrzucane, więc nie ma tu historii zamówień ani konta klienta. Kupowanie odbywa się w twoim sklepie: przycisk przenosi kupującego do twojej kasy z dodanym produktem. Ceny przychodzą w walucie sklepu, tak jak podaje je sklep. Test connection odczytuje jeden produkt.

Do czego: witryna sklepowa, która pokazuje twoje prawdziwe produkty z PrestaShop i przenosi kupujących na stronę każdego produktu w twoim sklepie.

Łączy się przez: klucze.

• Shop address: adres, pod którym działa twój sklep, ten, za którym stoi /admin.
• Webservice key: 32 litery i cyfry. W PrestaShop otwórz Advanced Parameters, potem Web service, potem Add new webservice key i zaznacz View (GET) przy products.

Klucz zostaje na serwerach Setherion.

Poproś o:

• „Pokaż moje produkty z PrestaShop z ich zdjęciami i cenami”
• „Połącz każdy produkt z jego stroną w moim sklepie”

Ograniczenia: produkty to jedyna rzecz, którą aplikacja może odczytać. Zamówienia i klienci są odrzucane, a stany magazynowe są niedostępne, więc aplikacja nie pokazuje znaczków „in stock”. Ceny w PrestaShop nie zawierają podatku, a aplikacja tak je oznacza. Kupujący trafiają na stronę produktu w twoim sklepie, a nie prosto do koszyka.