Demo na żywo

Płatności dla oprogramowania turystycznego

Integracja z API Paddle: kiedy merchant of record pasuje do firmy turystycznej

Paddle sprzedaje oprogramowanie, SaaS i produkty cyfrowe w Twoim imieniu jako merchant of record. Dlatego świetnie sprawdza się w firmie technologii turystycznych, która rozlicza własne subskrypcje, a zwykle jest złym narzędziem do przyjmowania płatności za loty, hotele i wycieczki. Ta strona wyjaśnia różnicę, jak działa integracja z Paddle i jak podłączyć ją do PHPTRAVELS, gdy pasuje do Twojego przypadku.

  • Merchant of record, nie bramka
  • Stworzona dla oprogramowania i subskrypcji
  • Podpisane webhooki
  • Podłączana jako integracja na zamówienie

Dwa różne modele

Merchant of record a bramka płatności

Bramka płatności przesyła pieniądze za Ciebie: sprzedawcą jesteś Ty, firma płatnicza przetwarza kartę, a podatki, faktury, zwroty i spory pozostają po Twojej stronie. Merchant of record idzie krok dalej i staje się sprzedawcą w oczach klienta i urzędów skarbowych. Gdy ktoś kupuje przez Paddle, to Paddle sprzedaje, pobiera i odprowadza podatek od sprzedaży lub VAT, wystawia fakturę, obsługuje chargebacki, a potem wypłaca Ci Twoją część.

Taki model oszczędza firmie programistycznej mnóstwo pracy podatkowej i zgodności, ale oznacza też, że to Paddle decyduje, co zgadza się odsprzedawać. Jej platforma jest stworzona dla oprogramowania, SaaS i produktów cyfrowych, nie dla usług turystycznych świadczonych przez linie lotnicze, hotele i organizatorów wycieczek. Ogólne zasady płatności kartą opisuje strona API bramki płatności.

Schemat przepływu płatności, w którym klient płaci online, a odpowiedzialność za płatność, podatek i wypłatę przechodzi między sprzedawcą a dostawcą płatności
PytaniePaddle (merchant of record)Bramka płatności
Kto jest sprzedawcą?Sprzedawcą jest Paddle. Pokwitowanie i pozycja na wyciągu z karty klienta pochodzą ze strony Paddle.Sprzedawcą jesteś Ty. Bramka tylko przetwarza płatność na Twoim koncie akceptanta.
Kto obsługuje podatek od sprzedaży i VAT?Paddle oblicza, pobiera i odprowadza podatek od sprzedaży oraz VAT tam, gdzie sprzedaje.Ty, na podstawie własnych rejestracji podatkowych, księgowego i fakturowania.
Kto wystawia fakturę?Paddle wystawia fakturę lub pokwitowanie kupującemu.Wystawia ją Twój system, na przykład fakturę rezerwacji w panelu admina.
Kto obsługuje chargebacki?Paddle zajmuje się sporami i chargebackami jako sprzedawca.Na spory odpowiadasz Ty, z dowodami, przez panel lub API bramki.
Co możesz sprzedawać?Oprogramowanie, SaaS, subskrypcje i produkty cyfrowe, w ramach zasad dopuszczalnego użytkowania Paddle.Sprzedaż towarów i usług zatwierdzoną przez bramkę, w tym rezerwacje podróży u wielu akceptantów z branży.
Jak otrzymujesz pieniądze?Paddle wypłaca zarobki po odliczeniu opłat, według własnego harmonogramu wypłat.Zrealizowane płatności trafiają na Twoje konto akceptanta lub bankowe, pomniejszone o opłaty bramki.

Opłaty, obsługiwane kraje i dokładną listę dozwolonych produktów ustala Paddle i zmieniają się one w czasie. Sprawdź warunki Paddle, zanim na niej oprzesz plany.

Pomoc w decyzji

Czy Paddle pasuje do tego, co sprzedajesz?

Zacznij od tego, za co płaci klient. Wybierz scenariusz najbliższy Twojej działalności.

01

Podróżni płacą za loty, hotele i wycieczki

Klient kupuje podróż realizowaną przez linię lotniczą, hotel lub organizatora wycieczek. Takie płatności często wymagają autoryzacji teraz i pobrania później, częściowych zwrotów po opłatach za anulowanie oraz kasy w wielu walutach.

Nasza opinia

Użyj bramki płatności

Sprawdź zasady dopuszczalnego użytkowania Paddle, zanim użyjesz jej do rezerwacji podróży. Większość firm turystycznych przyjmuje płatności za rezerwacje przez bramkę płatności, taką jak Stripe, PayPal, Adyen lub bramkę regionalną.

02

Sprzedajesz własne oprogramowanie turystyczne lub SaaS

Jesteś dostawcą technologii turystycznych, a agencje płacą Ci miesięczną lub roczną subskrypcję za narzędzie rezerwacyjne, dostęp do API, wtyczkę lub portal white label.

Nasza opinia

Paddle może pasować

To rodzaj sprzedaży, do którego stworzono merchant of record: Paddle rozlicza subskrypcję, obsługuje podatek w każdym kraju i wypłaca Ci pieniądze, więc nie musisz rejestrować się do VAT wszędzie, gdzie są Twoi klienci.

03

Sprzedajesz rezerwacje i oprogramowanie

Twoja agencja prowadzi serwis rezerwacyjny dla podróżnych i jednocześnie licencjonuje platformę lub narzędzia innym agencjom.

Nasza opinia

Użyj obu, osobno

Płatności za rezerwacje przyjmuj gotową bramką w procesie rezerwacji, a subskrypcje oprogramowania rozliczaj przez Paddle. Dwa przepływy, dwa zestawy zapisów, każdy z właściwym traktowaniem podatkowym.

Jak to działa

Jak działa integracja z Paddle, od początku do końca

Paddle Billing opiera się na produktach i cenach tworzonych w Paddle, kasie otwieranej przez Paddle.js oraz webhookach, które informują Twój serwer o tym, co się stało.

  1. 01

    Produkty i ceny

    Każdy plan tworzysz w Paddle raz, na przykład cenę miesięczną i roczną, a identyfikatory cen przechowujesz w swoim systemie.

    pri_…

  2. 02

    Kasa Paddle.js

    Twoja strona ładuje Paddle.js i otwiera kasę jako nakładkę lub ramkę wbudowaną, z identyfikatorem ceny i Twoim odnośnikiem do klienta.

    Paddle.Checkout.open()

  3. 03

    Transakcja zakończona

    Kupujący płaci, Paddle obciąża kartę lub portfel, nalicza podatek i tworzy transakcję, a także subskrypcję, gdy cena jest cykliczna.

    txn_…

  4. 04

    Podpisany webhook

    Paddle wysyła na Twój endpoint zdarzenie, np. transaction.completed, podpisane w nagłówku Paddle-Signature.

    transaction.completed

  5. 05

    Działa Twój system

    Twój serwer weryfikuje podpis, a następnie aktywuje konto, odnawia plan lub rejestruje płatność.

    200 OK

Klucz API trzymaj wyłącznie na serwerze. Przeglądarka używa osobnego tokenu po stronie klienta, a środowiska sandbox i produkcyjne mają własne klucze, ceny i sekrety webhooków.

Bezpieczeństwo webhooków

Sprawdzanie nagłówka Paddle-Signature

Webhook może podrobić każdy, kto zna adres URL Twojego endpointu. Weryfikacja podpisu każdego zdarzenia sprawia, że bezpiecznie można aktywować konto na podstawie webhooka.

paddle-webhook.php
 1$raw    = file_get_contents("php://input"); 2$header = $_SERVER["HTTP_PADDLE_SIGNATURE"] ?? "";  // ts=…;h1=… 3parse_str(str_replace(";", "&", $header), $sig); 4 5$expected = hash_hmac("sha256", $sig["ts"] . ":" . $raw, $endpointSecret); 6if (!hash_equals($expected, $sig["h1"] ?? "")) { 7    http_response_code(400); exit;            // not from Paddle 8} 9if (time() - (int) $sig["ts"] > $tolerance) exit; // too old1011$event = json_decode($raw, true);12if (alreadyHandled($event["event_id"])) exit;      // repeat delivery13if ($event["event_type"] === "transaction.completed") {14    activatePlan($event["data"]["custom_data"]["account_id"]);15}16http_response_code(200);

Przykład poglądowy w czystym PHP. Dokładny format znajdziesz w aktualnej dokumentacji Paddle lub jej oficjalnym SDK.

  1. 01

    Użyj surowej treści

    Podpis liczony jest z treści żądania dokładnie w takiej postaci, w jakiej przyszła, więc odczytaj ją, zanim parsowanie JSON ją zmieni.

  2. 02

    Znacznik czasu i hash

    Nagłówek zawiera znacznik czasu i hash HMAC-SHA256 utworzony kluczem tajnym endpointu. Odtwórz go i porównaj w stałym czasie.

  3. 03

    Odrzucaj stare i powtórzone zdarzenia

    Odrzucaj zdarzenia ze zbyt starym znacznikiem czasu i zapisuj identyfikator każdego zdarzenia, by powtórzona dostawa nie została przetworzona dwa razy.

  4. 04

    Najpierw sandbox

    Buduj i testuj w sandboxie Paddle na kartach testowych, a potem przełącz klucze, ceny i sekret na środowisko produkcyjne.

PHPTRAVELS i Paddle

Podłączanie Paddle do PHPTRAVELS

Najpierw uczciwa odpowiedź, potem opcje.

Paddle nie jest gotowym konektorem

Paddle nie ma na liście bramek płatności PHPTRAVELS i nie ma opublikowanego przewodnika konfiguracji. Gotowe bramki, pokazane niżej, są stworzone do przyjmowania płatności za rezerwacje.

Zapytaj o integrację na zamówienieWypróbuj demo rezerwacji

  • Do płatności za rezerwacje: gotowa bramka

    Włącz w panelu admina gotową bramkę, np. Płatności Stripe lub Płatności PayPal, na własnym koncie akceptanta. Kasa, zwroty i numer rezerwacji są już wpięte w proces rezerwacji, jak opisuje strona Integracja bramek płatniczych.

  • Do sprzedaży oprogramowania: Paddle jako integracja na zamówienie

    Gdy Twój przypadek mieści się w zasadach Paddle, nasi programiści mogą ją podłączyć jako Integracja API na zamówienie: kasa Paddle.js na Twojej stronie, zweryfikowany endpoint webhooka i płatności zapisywane przy Twoich klientach. Prace są wyceniane przed rozpoczęciem.

  • Albo zbuduj to sam na kodzie źródłowym

    PHPTRAVELS jest instalowany na własnym serwerze i zawiera pełny kod źródłowy, więc Twoi programiści mogą dodać Paddle do subskrypcji obok silnika rezerwacji. Strona Cennik wymienia, co obejmuje każda licencja.

Gotowe do płatności za rezerwacje

Bramki płatności już podłączone do PHPTRAVELS

Do płatności podróżnych i agentów te bramki są gotowe: zakładasz konto u dostawcy, wpisujesz klucze w panelu admina, testujesz i uruchamiasz produkcję. Lista pochodzi na żywo z naszego katalogu integracji.

Subagenci mogą też płacić z salda przedpłaconego lub limitu kredytowego przez Portfel B2B agenta, co nie wymaga żadnej bramki.

FAQ

Integracja z API Paddle: najczęstsze pytania

Kontakt ze sprzedażą

Nie jako gotowy konektor. Paddle nie ma na liście bramek płatności PHPTRAVELS. Jeśli Twój przypadek mieści się w zasadach Paddle, na przykład sprzedaż subskrypcji własnego oprogramowania, można ją dodać jako integrację na zamówienie lub zbudować własnymi siłami na dołączonym kodzie źródłowym.

Paddle to merchant of record stworzony dla oprogramowania, SaaS i produktów cyfrowych, więc zwykle nie jest narzędziem do lotów, hoteli czy wycieczek. Sprawdź zasady dopuszczalnego użytkowania Paddle, zanim użyjesz jej do rezerwacji podróży; większość firm turystycznych przyjmuje płatności przez bramkę, taką jak Stripe, PayPal, Adyen lub bramkę regionalną.

Firma, która prawnie sprzedaje klientowi. Odpowiada za pobieranie i odprowadzanie podatku od sprzedaży lub VAT, wystawianie faktur, obsługę zwrotów i chargebacków, a także widnieje na wyciągu klienta. W przypadku Paddle to Paddle przejmuje tę rolę i wypłaca Ci środki.

Bramka przetwarza płatności za Ciebie, a Ty pozostajesz sprzedawcą i zachowujesz pracę z podatkami i sporami. Paddle sama zostaje sprzedawcą, co eliminuje tę pracę przy sprzedaży oprogramowania, ale ogranicza to, co możesz przez nią sprzedawać.

Gdy sprzedajesz własne oprogramowanie, a nie podróże: narzędzie rezerwacyjne, API, wtyczkę lub portal white label, za które agencje płacą subskrypcją. Paddle może wtedy je rozliczać i obsługiwać podatek w każdym kraju.

Paddle wysyła zdarzenia, takie jak zakończona transakcja lub odnowiona subskrypcja, na zarejestrowany przez Ciebie adres URL. Każde żądanie ma nagłówek Paddle-Signature ze znacznikiem czasu i hashem, które Twój serwer sprawdza kluczem tajnym endpointu, zanim cokolwiek zrobi.

Tak. Paddle ma osobne środowisko sandbox z własnym kontem, kluczami API, cenami i kartami testowymi. Buduj i testuj tam, a potem przenieś konfigurację do środowiska produkcyjnego.

Tak, jako dwa osobne przepływy: silnik rezerwacji przyjmuje płatności podróżnych przez gotową bramkę, a Paddle rozlicza subskrypcje Twojego oprogramowania. Trzymaj ich zapisy osobno, by każda sprzedaż miała właściwe traktowanie podatkowe.

Odkryj więcej

Więcej o platformie