Live-Demo

Zahlungen für Reisesoftware

Paddle-API-Integration: wann ein Merchant of Record zu einem Reiseunternehmen passt

Paddle verkauft Software, SaaS und digitale Produkte in Ihrem Namen als Merchant of Record. Das passt gut zu einem Reisetechnologie-Unternehmen, das eigene Abos abrechnet, ist aber meist das falsche Werkzeug, um Geld für Flüge, Hotels und Touren einzunehmen. Diese Seite erklärt den Unterschied, wie eine Paddle-Integration funktioniert und wie Sie Paddle mit PHPTRAVELS verbinden, wenn Ihr Anwendungsfall passt.

  • Merchant of Record, kein Gateway
  • Für Software und Abonnements gebaut
  • Signierte Webhooks
  • Als individuelle Integration angebunden

Zwei verschiedene Modelle

Merchant of Record vs. Payment Gateway

Ein Payment Gateway bewegt das Geld für Sie: Sie sind der Verkäufer, das Zahlungsunternehmen verarbeitet die Karte, und Steuern, Rechnungen, Erstattungen und Streitfälle bleiben Ihre Aufgabe. Ein Merchant of Record geht einen Schritt weiter und wird in den Augen von Kunden und Steuerbehörden selbst zum Verkäufer. Kauft jemand über Paddle, verkauft Paddle an ihn, erhebt und führt Umsatzsteuer oder VAT ab, stellt die Rechnung aus, bearbeitet Rückbuchungen und zahlt Ihnen anschließend Ihren Anteil aus.

Dieses Modell erspart einem Softwareunternehmen viel Steuer- und Compliance-Arbeit, bedeutet aber auch, dass Paddle entscheidet, was es weiterverkaufen möchte. Die Plattform ist für Software, SaaS und digitale Produkte gebaut, nicht für Reiseleistungen von Airlines, Hotels und Reiseveranstaltern. Die allgemeine Funktionsweise von Kartenzahlungen behandelt die Seite Payment-Gateway-API.

Ein Diagramm eines Zahlungsablaufs: Ein Kunde zahlt online, und Zahlungs-, Steuer- und Auszahlungspflichten gehen zwischen Verkäufer und Zahlungsanbieter über
FragePaddle (Merchant of Record)Payment Gateway
Wer ist der Verkäufer?Paddle ist der Merchant of Record. Beleg und Kartenabrechnung des Kunden stammen von Paddles Seite des Verkaufs.Sie sind der Verkäufer. Das Gateway verarbeitet die Zahlung nur auf Ihrem Händlerkonto.
Wer kümmert sich um Umsatzsteuer und VAT?Paddle berechnet, erhebt und führt Umsatzsteuer und VAT in den Ländern ab, in die es verkauft.Sie, über Ihre eigenen Steuerregistrierungen, Ihren Steuerberater und Ihre Rechnungsstellung.
Wer stellt die Rechnung aus?Paddle stellt dem Käufer die Rechnung oder den Beleg aus.Ihr eigenes System, zum Beispiel die Buchungsrechnung in Ihrem Admin.
Wer bearbeitet Rückbuchungen?Paddle kümmert sich als Verkäufer um Streitfälle und Rückbuchungen.Sie beantworten Streitfälle mit Nachweisen über das Dashboard oder die API des Gateways.
Was können Sie verkaufen?Software, SaaS, Abonnements und digitale Produkte im Rahmen von Paddles Nutzungsrichtlinien.Physische Waren und Dienstleistungen, die das Gateway zulässt, bei vielen Reiseanbietern auch Reisebuchungen.
Wie werden Sie bezahlt?Paddle zahlt Ihre Einnahmen nach Abzug seiner Gebühren nach seinem Auszahlungsplan aus.Eingezogene Zahlungen werden abzüglich der Gateway-Gebühren auf Ihr Händler- oder Bankkonto ausgezahlt.

Gebühren, unterstützte Länder und die genaue Liste zulässiger Produkte legt Paddle fest, und sie ändern sich mit der Zeit. Prüfen Sie Paddles eigene Bedingungen, bevor Sie darauf planen.

Entscheidungshilfe

Ist Paddle das Richtige für das, was Sie verkaufen?

Gehen Sie davon aus, wofür der Kunde zahlt. Wählen Sie das Szenario, das Ihrem Geschäft am nächsten kommt.

01

Reisende zahlen für Flüge, Hotels und Touren

Der Kunde kauft eine Reise, die eine Airline, ein Hotel oder ein Reiseveranstalter erbringt. Bei solchen Zahlungen braucht es oft Autorisierung jetzt und Capture später, Teilerstattungen nach Stornogebühren und einen Checkout in mehreren Währungen.

Unsere Einschätzung

Nutzen Sie ein Payment Gateway

Prüfen Sie Paddles Nutzungsrichtlinien, bevor Sie es für Reisebuchungen einsetzen. Die meisten Reiseunternehmen nehmen Buchungszahlungen über ein Payment Gateway wie Stripe, PayPal, Adyen oder ein regionales Gateway an.

02

Sie verkaufen eigene Reisesoftware oder SaaS

Sie sind Anbieter von Reisetechnologie, und Agenturen zahlen Ihnen ein monatliches oder jährliches Abo für Ihr Buchungstool, den API-Zugang, ein Plugin oder ein White-Label-Portal.

Unsere Einschätzung

Paddle kann passen

Genau für diese Art von Verkauf ist ein Merchant of Record gemacht: Paddle rechnet das Abo ab, kümmert sich in jedem Land um die Steuer und zahlt an Sie aus, sodass Sie sich nicht überall dort für die Umsatzsteuer registrieren müssen, wo Ihre Kunden sitzen.

03

Sie verkaufen Buchungen und Software

Ihre Agentur betreibt eine Buchungsseite für Reisende und lizenziert zugleich ihre Plattform oder Tools an andere Agenturen.

Unsere Einschätzung

Beides nutzen, getrennt halten

Nehmen Sie Buchungszahlungen im Buchungsablauf über ein fertiges Gateway an und rechnen Sie die Softwareabos über Paddle ab. Zwei Abläufe, zwei Buchhaltungen, jeweils mit der richtigen steuerlichen Behandlung.

So funktioniert es

Wie eine Paddle-Integration funktioniert, von Anfang bis Ende

Paddle Billing arbeitet mit Produkten und Preisen, die Sie in Paddle anlegen, einem Checkout, den Paddle.js öffnet, und Webhooks, die Ihrem Server mitteilen, was passiert ist.

  1. 01

    Produkte und Preise

    Sie legen jeden Tarif einmal in Paddle an, zum Beispiel einen Monats- und einen Jahrespreis, und speichern die Preis-IDs in Ihrem System.

    pri_…

  2. 02

    Paddle.js-Checkout

    Ihre Seite lädt Paddle.js und öffnet den Checkout als Overlay oder eingebetteten Frame mit der Preis-ID und Ihrer eigenen Kundenreferenz.

    Paddle.Checkout.open()

  3. 03

    Transaktion abgeschlossen

    Der Käufer zahlt, Paddle belastet Karte oder Wallet, wendet die Steuer an und legt eine Transaktion an, bei wiederkehrendem Preis auch ein Abonnement.

    txn_…

  4. 04

    Signierter Webhook

    Paddle sendet ein Ereignis wie transaction.completed an Ihren Endpunkt, signiert im Header Paddle-Signature.

    transaction.completed

  5. 05

    Ihr System handelt

    Ihr Server prüft die Signatur und aktiviert dann das Konto, verlängert den Tarif oder verbucht die Zahlung.

    200 OK

Der API-Schlüssel gehört ausschließlich auf Ihren Server. Der Browser nutzt ein separates clientseitiges Token, und Sandbox und Live-Umgebung haben jeweils eigene Schlüssel, Preise und Webhook-Secrets.

Webhook-Sicherheit

Den Header Paddle-Signature prüfen

Einen Webhook kann jeder fälschen, der die URL Ihres Endpunkts kennt. Erst die Prüfung der Signatur bei jedem Ereignis macht es sicher, ein Konto aufgrund eines Webhooks zu aktivieren.

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);

Beispiel zur Veranschaulichung in reinem PHP. Für das genaue Format folgen Sie der aktuellen Dokumentation von Paddle oder dem offiziellen SDK.

  1. 01

    Rohen Body verwenden

    Die Signatur wird über den Request-Body genau so berechnet, wie er ankommt. Lesen Sie ihn also, bevor ein JSON-Parsing ihn verändert.

  2. 02

    Zeitstempel plus Hash

    Der Header enthält einen Zeitstempel und einen HMAC-SHA256-Hash, gebildet mit dem geheimen Schlüssel Ihres Endpunkts. Bilden Sie ihn nach und vergleichen Sie in konstanter Zeit.

  3. 03

    Alte und wiederholte Ereignisse ablehnen

    Lehnen Sie Ereignisse mit zu altem Zeitstempel ab und speichern Sie jede Ereignis-ID, damit eine erneute Zustellung nicht doppelt verarbeitet wird.

  4. 04

    Zuerst die Sandbox

    Bauen und testen Sie gegen Paddles Sandbox mit Testkarten und stellen Sie dann Schlüssel, Preise und Secret auf Live um.

PHPTRAVELS und Paddle

Paddle mit PHPTRAVELS verbinden

Zuerst eine ehrliche Antwort, dann die Möglichkeiten.

Paddle ist kein fertiger Konnektor

Paddle steht nicht in der Payment-Gateway-Liste von PHPTRAVELS und hat keine veröffentlichte Einrichtungsanleitung. Die fertigen Gateways unten sind die, die für Buchungszahlungen gebaut sind.

Zur individuellen Integration anfragenBuchungs-Demo testen

  • Für Buchungszahlungen: ein fertiges Gateway

    Aktivieren Sie im Admin mit Ihrem eigenen Händlerkonto ein fertiges Gateway wie Stripe-Zahlungen oder PayPal-Zahlungen. Checkout, Erstattungen und Buchungsreferenz sind bereits in den Buchungsablauf eingebunden, wie die Seite Zahlungs-Gateway-Integration erklärt.

  • Für Softwareverkäufe: Paddle als individuelle Integration

    Wenn Ihr Anwendungsfall zu Paddles Regeln passt, können unsere Entwickler es als Individuelle API-Integration anbinden: Paddle.js-Checkout auf Ihrer Seite, ein geprüfter Webhook-Endpunkt und Zahlungen, die Ihren Kunden zugeordnet werden. Der Aufwand wird vor Beginn angeboten.

  • Oder selbst auf dem Quellcode bauen

    PHPTRAVELS ist selbst gehostet und wird mit vollständigem Quellcode geliefert, sodass Ihre eigenen Entwickler Paddle für Abos neben der Buchungsmaschine ergänzen können. Auf der Seite Preise steht, was jede Lizenz enthält.

Bereit für Buchungszahlungen

Payment Gateways, die bereits mit PHPTRAVELS verbunden sind

Für Zahlungen von Reisenden und Agenten sind diese Gateways bereit: Sie eröffnen ein Konto beim Anbieter, tragen Ihre Schlüssel im Admin ein, testen und gehen live. Die Liste stammt live aus unserem Integrationsverzeichnis.

Subagenten können auch von einem Guthaben oder Kreditlimit über das B2B-Agenten-Wallet bezahlen, wofür gar kein Gateway nötig ist.

FAQ

Paddle-API-Integration: häufige Fragen

Vertrieb kontaktieren

Nicht als fertiger Konnektor. Paddle steht nicht in der Payment-Gateway-Liste von PHPTRAVELS. Passt Ihr Anwendungsfall zu Paddles Regeln, etwa beim Verkauf eigener Software-Abos, lässt es sich als individuelle Integration ergänzen oder von Ihren Entwicklern auf dem mitgelieferten Quellcode bauen.

Paddle ist ein Merchant of Record für Software, SaaS und digitale Produkte und deshalb in der Regel nicht das Werkzeug für Flüge, Hotels oder Touren. Prüfen Sie Paddles Nutzungsrichtlinien, bevor Sie es für Reisebuchungen einsetzen; die meisten Reiseunternehmen nehmen Buchungszahlungen über ein Payment Gateway wie Stripe, PayPal, Adyen oder ein regionales Gateway an.

Das Unternehmen, das rechtlich an den Kunden verkauft. Es ist zuständig für Erhebung und Abführung von Umsatzsteuer oder VAT, Rechnungsstellung, Erstattungen und Rückbuchungen und erscheint auf der Abrechnung des Kunden. Bei Paddle übernimmt Paddle diese Rolle und zahlt Sie aus.

Ein Gateway verarbeitet Zahlungen für Sie, während Sie Verkäufer bleiben und Steuer und Streitfälle selbst erledigen. Paddle wird selbst zum Verkäufer, was diese Arbeit bei Softwareverkäufen entfallen lässt, aber einschränkt, was Sie darüber verkaufen können.

Wenn Sie eigene Software statt Reisen verkaufen: ein Buchungstool, eine API, ein Plugin oder ein White-Label-Portal, das Agenturen im Abo bezahlen. Paddle kann sie dann abrechnen und in jedem Land die Steuer übernehmen.

Paddle sendet Ereignisse wie eine abgeschlossene Transaktion oder ein verlängertes Abo an eine URL, die Sie registrieren. Jede Anfrage trägt einen Header Paddle-Signature mit Zeitstempel und Hash, den Ihr Server mit dem geheimen Schlüssel des Endpunkts prüft, bevor er handelt.

Ja. Paddle hat eine eigene Sandbox-Umgebung mit eigenem Konto, eigenen API-Schlüsseln, Preisen und Testkarten. Bauen und testen Sie dort und übertragen Sie die Konfiguration dann in die Live-Umgebung.

Ja, als zwei getrennte Abläufe: Die Buchungsmaschine nimmt Zahlungen von Reisenden über ein fertiges Gateway an, und Paddle rechnet Ihre Softwareabos ab. Halten Sie die Unterlagen getrennt, damit jeder Verkauf die richtige steuerliche Behandlung erhält.

Weiter entdecken

Mehr zur Plattform