Live demo

Betalingen voor reissoftware

Paddle-API-integratie: wanneer een merchant of record past bij een reisbedrijf

Paddle verkoopt software, SaaS en digitale producten namens jou als merchant of record. Dat past goed bij een reistechnologiebedrijf dat zijn eigen abonnementen factureert, en meestal slecht bij het innen van geld voor vluchten, hotels en rondreizen. Deze pagina legt het verschil uit, hoe een Paddle-integratie werkt en hoe je Paddle aan PHPTRAVELS koppelt als jouw situatie past.

  • Merchant of record, geen gateway
  • Gebouwd voor software en abonnementen
  • Ondertekende webhooks
  • Gekoppeld als maatwerkintegratie

Twee verschillende modellen

Merchant of record versus betaalgateway

Een betaalgateway verplaatst het geld voor je: jij bent de verkoper, het betaalbedrijf verwerkt de kaart, en btw, facturen, terugbetalingen en geschillen blijven jouw verantwoordelijkheid. Een merchant of record gaat een stap verder en wordt in de ogen van de klant en de belastingdienst zelf de verkoper. Koopt iemand via Paddle, dan verkoopt Paddle aan die persoon, int en draagt het de omzetbelasting of btw af, stelt het de factuur op, handelt het chargebacks af en betaalt het jou daarna jouw deel uit.

Dit model scheelt een softwarebedrijf veel belasting- en compliancewerk, maar betekent ook dat Paddle bepaalt wat het wil doorverkopen. Het platform is gebouwd voor software, SaaS en digitale producten, niet voor reisdiensten van luchtvaartmaatschappijen, hotels en touroperators. De algemene werking van kaartbetalingen staat op de pagina Betaalgateway-API.

Een diagram van een betaalstroom waarin een klant online betaalt en de verantwoordelijkheden voor betaling, belasting en uitbetaling heen en weer gaan tussen een verkoper en een betaalprovider
VraagPaddle (merchant of record)Betaalgateway
Wie is de verkoper?Paddle is de verkoper van record. Het bewijs van aankoop en de afschrijving van de klant komen van Paddles kant van de verkoop.Jij bent de verkoper. De gateway verwerkt alleen de betaling op jouw merchant-account.
Wie regelt omzetbelasting en btw?Paddle berekent, int en draagt omzetbelasting en btw af in de landen waar het verkoopt.Jij, via je eigen belastingregistraties, boekhouder en facturatie.
Wie stelt de factuur op?Paddle stelt de factuur of het bewijs van aankoop op voor de koper.Je eigen systeem, bijvoorbeeld de boekingsfactuur in je beheeromgeving.
Wie handelt chargebacks af?Paddle handelt geschillen en chargebacks af als verkoper.Jij beantwoordt geschillen met bewijs via het dashboard of de API van de gateway.
Wat kun je verkopen?Software, SaaS, abonnementen en digitale producten, binnen Paddles regels voor toegestaan gebruik.Fysieke producten en diensten die de gateway goedkeurt, waaronder reisboekingen voor veel reisbedrijven.
Hoe word je betaald?Paddle betaalt je opbrengst uit na aftrek van zijn kosten, volgens zijn uitbetalingsschema.Geïnde betalingen worden op je merchant- of bankrekening verrekend, min de kosten van de gateway.

Tarieven, ondersteunde landen en de exacte lijst met toegestane producten bepaalt Paddle zelf, en ze veranderen in de loop van de tijd. Lees Paddles eigen voorwaarden voordat je erop rekent.

Keuzehulp

Is Paddle de juiste keuze voor wat jij verkoopt?

Begin bij waarvoor de klant betaalt. Kies het scenario dat het dichtst bij jouw bedrijf ligt.

01

Reizigers betalen voor vluchten, hotels en rondreizen

De klant koopt een reis die een luchtvaartmaatschappij, hotel of touroperator uitvoert. Zulke betalingen vragen vaak om nu autoriseren en later incasseren, gedeeltelijke terugbetalingen na annuleringskosten en afrekenen in meerdere valuta.

Ons oordeel

Gebruik een betaalgateway

Controleer Paddles regels voor toegestaan gebruik voordat je het voor reisboekingen inzet. De meeste reisbedrijven innen boekingsbetalingen via een betaalgateway zoals Stripe, PayPal, Adyen of een regionale gateway.

02

Je verkoopt je eigen reissoftware of SaaS

Je bent een reistechnologieleverancier en reisbureaus betalen jou een maand- of jaarabonnement voor je boekingstool, API-toegang, een plug-in of een white-label portaal.

Ons oordeel

Paddle kan passen

Dit is het soort verkoop waarvoor een merchant of record gebouwd is: Paddle factureert het abonnement, regelt de belasting in elk land en betaalt jou uit, zodat je je niet overal waar je klanten zitten voor btw hoeft te registreren.

03

Je verkoopt boekingen en software

Je bureau runt een boekingssite voor reizigers en geeft daarnaast het platform of de tools in licentie aan andere bureaus.

Ons oordeel

Gebruik beide, gescheiden

Neem boekingsbetalingen aan via een kant-en-klare gateway in de boekingsflow en factureer de softwareabonnementen via Paddle. Twee stromen, twee administraties, elk met de juiste belastingbehandeling.

Hoe het werkt

Hoe een Paddle-integratie werkt, van begin tot eind

Paddle Billing werkt met producten en prijzen die je in Paddle aanmaakt, een checkout die Paddle.js opent en webhooks die je server vertellen wat er gebeurd is.

  1. 01

    Producten en prijzen

    Je maakt elk abonnement één keer aan in Paddle, bijvoorbeeld een maand- en een jaarprijs, en bewaart de prijs-ID's in je systeem.

    pri_…

  2. 02

    Paddle.js-checkout

    Je pagina laadt Paddle.js en opent de checkout als overlay of ingebed frame met de prijs-ID en je eigen klantreferentie.

    Paddle.Checkout.open()

  3. 03

    Transactie voltooid

    De koper betaalt, Paddle belast de kaart of wallet, past belasting toe en maakt een transactie aan, en een abonnement als de prijs terugkeert.

    txn_…

  4. 04

    Ondertekende webhook

    Paddle stuurt een gebeurtenis zoals transaction.completed naar je endpoint, ondertekend in de header Paddle-Signature.

    transaction.completed

  5. 05

    Je systeem handelt

    Je server controleert de handtekening en activeert dan het account, verlengt het abonnement of legt de betaling vast.

    200 OK

Bewaar de API-sleutel alleen op je server. De browser gebruikt een apart client-side token, en de sandbox- en live-omgeving hebben elk eigen sleutels, prijzen en webhook-geheimen.

Webhookbeveiliging

De header Paddle-Signature controleren

Een webhook kan door iedereen worden nagemaakt die de URL van je endpoint kent. Pas als je bij elke gebeurtenis de handtekening controleert, is het veilig om op basis van een webhook een account te activeren.

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

Illustratief voorbeeld in gewone PHP. Volg voor het exacte formaat de actuele documentatie van Paddle of de officiële SDK.

  1. 01

    Gebruik de ruwe body

    De handtekening wordt berekend over de request-body precies zoals die binnenkomt, dus lees hem uit voordat JSON-parsing hem verandert.

  2. 02

    Tijdstempel plus hash

    De header bevat een tijdstempel en een HMAC-SHA256-hash, gemaakt met de geheime sleutel van je endpoint. Bouw hem na en vergelijk in constante tijd.

  3. 03

    Wijs oude en herhaalde gebeurtenissen af

    Weiger gebeurtenissen met een te oude tijdstempel en bewaar elke gebeurtenis-ID, zodat een herhaalde aflevering niet twee keer wordt verwerkt.

  4. 04

    Eerst de sandbox

    Bouw en test in Paddles sandbox met testkaarten en zet daarna sleutels, prijzen en geheim om naar live.

PHPTRAVELS en Paddle

Paddle koppelen aan PHPTRAVELS

Eerst een eerlijk antwoord, dan de opties.

Paddle is geen kant-en-klare connector

Paddle staat niet in de lijst met betaalgateways van PHPTRAVELS en heeft geen gepubliceerde installatiehandleiding. De kant-en-klare gateways hieronder zijn degene die gebouwd zijn voor boekingsbetalingen.

Vraag naar een maatwerkintegratieProbeer de boekingsdemo

  • Voor boekingsbetalingen: een kant-en-klare gateway

    Schakel in de beheeromgeving een kant-en-klare gateway zoals Stripe-betalingen of PayPal-betalingen in met je eigen merchant-account. Checkout, terugbetalingen en de boekingsreferentie zijn al in de boekingsflow ingebouwd, zoals de pagina Betaalgateway-integratie uitlegt.

  • Voor softwareverkoop: Paddle als maatwerkintegratie

    Als jouw situatie binnen Paddles regels past, kunnen onze ontwikkelaars het koppelen als API-integratie op maat: Paddle.js-checkout op je pagina, een geverifieerd webhook-endpoint en betalingen die aan je klanten worden gekoppeld. Het werk wordt vooraf geoffreerd.

  • Of bouw het zelf op de broncode

    PHPTRAVELS is zelf te hosten en wordt met de volledige broncode geleverd, zodat je eigen ontwikkelaars Paddle voor abonnementen naast de boekingsengine kunnen toevoegen. De pagina Prijzen laat zien wat elke licentie omvat.

Klaar voor boekingsbetalingen

Betaalgateways die al aan PHPTRAVELS zijn gekoppeld

Voor betalingen van reizigers en agenten zijn deze gateways klaar: je opent een account bij de provider, vult je sleutels in de beheeromgeving in, test en gaat live. De lijst is de actuele uit onze integratiegids.

Subagenten kunnen ook betalen met een vooruitbetaald saldo of kredietlimiet via de B2B-agentwallet, waarvoor helemaal geen gateway nodig is.

Veelgestelde vragen

Paddle-API-integratie: veelgestelde vragen

Praat met sales

Niet als kant-en-klare connector. Paddle staat niet in de lijst met betaalgateways van PHPTRAVELS. Past jouw situatie binnen Paddles regels, bijvoorbeeld het verkopen van abonnementen op je eigen software, dan kan het als maatwerkintegratie worden toegevoegd of door je ontwikkelaars op de meegeleverde broncode worden gebouwd.

Paddle is een merchant of record voor software, SaaS en digitale producten en dus meestal niet het juiste middel voor vluchten, hotels of rondreizen. Controleer Paddles regels voor toegestaan gebruik voordat je het voor reisboekingen inzet; de meeste reisbedrijven innen boekingsbetalingen via een betaalgateway zoals Stripe, PayPal, Adyen of een regionale gateway.

Het bedrijf dat juridisch aan de klant verkoopt. Het is verantwoordelijk voor het innen en afdragen van omzetbelasting of btw, het opstellen van facturen, het afhandelen van terugbetalingen en chargebacks, en staat op het afschrift van de klant. Bij Paddle neemt Paddle die rol op zich en betaalt het jou uit.

Een gateway verwerkt betalingen voor je terwijl jij de verkoper blijft en het belasting- en geschillenwerk houdt. Paddle wordt zelf de verkoper, waardoor dat werk bij softwareverkoop wegvalt, maar ook beperkt wat je erdoorheen kunt verkopen.

Als je je eigen software verkoopt in plaats van reizen: een boekingstool, een API, een plug-in of een white-label portaal waarvoor reisbureaus een abonnement betalen. Paddle kan hen dan factureren en in elk land de belasting regelen.

Paddle stuurt gebeurtenissen zoals een voltooide transactie of een verlengd abonnement naar een URL die je registreert. Elk verzoek bevat een header Paddle-Signature met een tijdstempel en een hash, die je server met de geheime sleutel van het endpoint controleert voordat hij handelt.

Ja. Paddle heeft een aparte sandbox-omgeving met een eigen account, API-sleutels, prijzen en testkaarten. Bouw en test daar en zet de configuratie daarna over naar de live-omgeving.

Ja, als twee gescheiden stromen: de boekingsengine neemt betalingen van reizigers aan via een kant-en-klare gateway en Paddle factureert je softwareabonnementen. Houd de administratie gescheiden, zodat elke verkoop de juiste belastingbehandeling krijgt.

Verder ontdekken

Meer over het platform