Démo en ligne

Paiements pour logiciels de voyage

Intégration API Paddle : quand un merchant of record convient à une activité de voyage

Paddle vend des logiciels, du SaaS et des produits numériques en votre nom, en tant que merchant of record. C'est un bon choix pour une entreprise de technologie du voyage qui facture ses propres abonnements, et en général le mauvais outil pour encaisser des vols, des hôtels et des circuits. Cette page explique la différence, le fonctionnement d'une intégration Paddle et la façon de la relier à PHPTRAVELS quand votre cas s'y prête.

  • Merchant of record, pas une passerelle
  • Conçu pour logiciels et abonnements
  • Webhooks signés
  • Raccordé comme intégration sur mesure

Deux modèles différents

Merchant of record ou passerelle de paiement

Une passerelle de paiement fait circuler l'argent pour vous : vous êtes le vendeur, la société de paiement traite la carte, et la taxe, les factures, les remboursements et les litiges restent à votre charge. Un merchant of record va un cran plus loin et devient le vendeur aux yeux du client et des administrations fiscales. Quand quelqu'un achète via Paddle, c'est Paddle qui vend, qui collecte et reverse la taxe de vente ou la TVA, qui émet la facture, gère les rétrofacturations puis vous verse votre part.

Ce modèle épargne à un éditeur de logiciels beaucoup de travail fiscal et de conformité, mais il signifie aussi que Paddle décide de ce qu'elle accepte de revendre. Sa plateforme est faite pour les logiciels, le SaaS et les produits numériques, pas pour des services de voyage fournis par des compagnies aériennes, des hôtels et des voyagistes. Le fonctionnement général des paiements par carte est détaillé sur la page API de passerelle de paiement.

Schéma d'un flux de paiement : un client paie en ligne pendant que les responsabilités de paiement, de taxe et de versement passent entre un vendeur et un prestataire de paiement
QuestionPaddle (merchant of record)Passerelle de paiement
Qui est le vendeur ?Paddle est le vendeur officiel. Le reçu et la ligne du relevé de carte du client viennent du côté Paddle de la vente.Vous êtes le vendeur. La passerelle ne fait que traiter le paiement sur votre compte marchand.
Qui gère la taxe de vente et la TVA ?Paddle calcule, collecte et reverse la taxe de vente et la TVA là où elle vend.Vous, avec vos propres immatriculations fiscales, votre comptable et votre facturation.
Qui émet la facture ?Paddle émet la facture ou le reçu à l'acheteur.Votre propre système l'émet, par exemple la facture de réservation dans votre admin.
Qui gère les rétrofacturations ?Paddle traite litiges et rétrofacturations en tant que vendeur.Vous répondez aux litiges avec des preuves, via le tableau de bord ou l'API de la passerelle.
Que pouvez-vous vendre ?Logiciels, SaaS, abonnements et produits numériques, dans le respect des règles d'utilisation acceptable de Paddle.Les ventes de biens et de services que la passerelle approuve, dont les réservations de voyage pour de nombreux marchands du secteur.
Comment êtes-vous payé ?Paddle vous verse vos revenus après déduction de ses frais, selon son calendrier de versements.Les paiements capturés sont réglés sur votre compte marchand ou bancaire, moins les frais de la passerelle.

Les frais, les pays pris en charge et la liste exacte des produits autorisés sont fixés par Paddle et évoluent. Consultez les conditions de Paddle avant de compter sur elle.

Aide à la décision

Paddle convient-elle à ce que vous vendez ?

Partez de ce que le client paie. Choisissez le scénario le plus proche de votre activité.

01

Les voyageurs paient vols, hôtels et circuits

Le client achète un voyage assuré par une compagnie aérienne, un hôtel ou un voyagiste. Ces paiements demandent souvent d'autoriser maintenant et de capturer plus tard, des remboursements partiels après frais d'annulation et un paiement multidevise.

Notre avis

Utilisez une passerelle de paiement

Vérifiez les règles d'utilisation acceptable de Paddle avant de l'employer pour des réservations de voyage. La plupart des acteurs du voyage encaissent leurs réservations via une passerelle de paiement comme Stripe, PayPal, Adyen ou une passerelle régionale.

02

Vous vendez votre propre logiciel de voyage ou SaaS

Vous êtes un éditeur de technologie du voyage et des agences vous paient un abonnement mensuel ou annuel pour votre outil de réservation, un accès API, un plugin ou un portail en marque blanche.

Notre avis

Paddle peut convenir

C'est le type de vente pour lequel un merchant of record est conçu : Paddle facture l'abonnement, gère la taxe dans chaque pays et vous reverse les fonds, sans que vous ayez à vous immatriculer à la TVA partout où se trouvent vos clients.

03

Vous vendez des réservations et un logiciel

Votre agence exploite un site de réservation pour les voyageurs et concède aussi sa plateforme ou ses outils à d'autres agences.

Notre avis

Utilisez les deux, séparément

Encaissez les réservations via une passerelle prête à l'emploi dans le parcours de réservation, et facturez les abonnements logiciels via Paddle. Deux flux, deux jeux d'écritures, chacun avec le bon traitement fiscal.

Comment ça marche

Comment fonctionne une intégration Paddle, de bout en bout

Paddle Billing repose sur des produits et des prix créés dans Paddle, un paiement ouvert par Paddle.js et des webhooks qui informent votre serveur de ce qui s'est passé.

  1. 01

    Produits et prix

    Vous créez chaque formule une seule fois dans Paddle, par exemple un prix mensuel et un annuel, et conservez les ID de prix dans votre système.

    pri_…

  2. 02

    Paiement Paddle.js

    Votre page charge Paddle.js et ouvre le paiement en surimpression ou en cadre intégré, avec l'ID du prix et votre référence client.

    Paddle.Checkout.open()

  3. 03

    Transaction terminée

    L'acheteur paie, Paddle débite la carte ou le wallet, applique la taxe et crée une transaction, ainsi qu'un abonnement si le prix est récurrent.

    txn_…

  4. 04

    Webhook signé

    Paddle envoie à votre endpoint un événement tel que transaction.completed, signé dans l'en-tête Paddle-Signature.

    transaction.completed

  5. 05

    Votre système agit

    Votre serveur vérifie la signature, puis active le compte, renouvelle la formule ou enregistre le paiement.

    200 OK

Gardez la clé API uniquement sur votre serveur. Le navigateur utilise un jeton côté client distinct, et les environnements sandbox et production ont chacun leurs clés, leurs prix et leurs secrets de webhook.

Sécurité des webhooks

Vérifier l'en-tête Paddle-Signature

N'importe qui connaissant l'URL de votre endpoint peut falsifier un webhook. Vérifier la signature de chaque événement est ce qui permet d'activer un compte à partir d'un webhook en toute sécurité.

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

Exemple illustratif en PHP pur. Pour le format exact, suivez la documentation actuelle de Paddle ou son SDK officiel.

  1. 01

    Utilisez le corps brut

    La signature est calculée sur le corps de la requête tel que reçu ; lisez-le avant qu'un décodage JSON ne le modifie.

  2. 02

    Horodatage plus hash

    L'en-tête contient un horodatage et un hash HMAC-SHA256 produit avec la clé secrète de l'endpoint. Reconstruisez-le et comparez en temps constant.

  3. 03

    Rejetez les événements anciens et répétés

    Refusez les événements dont l'horodatage est trop ancien et enregistrez l'ID de chaque événement pour qu'une livraison répétée ne soit pas traitée deux fois.

  4. 04

    Sandbox d'abord

    Développez et testez dans la sandbox de Paddle avec des cartes de test, puis passez les clés, les prix et le secret en production.

PHPTRAVELS et Paddle

Relier Paddle à PHPTRAVELS

D'abord une réponse franche, ensuite les options.

Paddle n'est pas un connecteur prêt à l'emploi

Paddle ne figure pas dans la liste des passerelles de paiement de PHPTRAVELS et n'a pas de guide de configuration publié. Les passerelles prêtes, présentées ci-dessous, sont celles conçues pour encaisser les réservations.

Demander une intégration sur mesureEssayer la démo de réservation

  • Pour les paiements de réservations : une passerelle prête

    Activez dans l'admin une passerelle prête comme Paiements Stripe ou Paiements PayPal avec votre propre compte marchand. Paiement, remboursements et référence de réservation sont déjà intégrés au parcours de réservation, comme l'explique la page Intégration de passerelles de paiement.

  • Pour la vente de logiciels : Paddle en intégration sur mesure

    Quand votre cas respecte les règles de Paddle, nos développeurs peuvent la raccorder comme Intégration d'API sur mesure : paiement Paddle.js sur votre page, endpoint de webhook vérifié et paiements enregistrés sur vos clients. Le travail est chiffré avant de commencer.

  • Ou développez-la vous-même sur le code source

    PHPTRAVELS est auto-hébergé et fourni avec son code source complet : vos propres développeurs peuvent donc ajouter Paddle pour les abonnements à côté du moteur de réservation. La page Tarifs détaille ce que comprend chaque licence.

Prêtes pour les paiements de réservations

Passerelles de paiement déjà reliées à PHPTRAVELS

Pour les paiements des voyageurs et des agents, ces passerelles sont prêtes : vous ouvrez un compte chez le prestataire, saisissez vos clés dans l'admin, testez et passez en production. La liste est celle, à jour, de notre répertoire d'intégrations.

Les sous-agents peuvent aussi payer avec un solde prépayé ou une limite de crédit via le Portefeuille agent B2B, sans aucune passerelle.

FAQ

Intégration API Paddle : questions fréquentes

Parler à un conseiller

Pas comme connecteur prêt à l'emploi. Paddle ne figure pas dans la liste des passerelles de paiement de PHPTRAVELS. Si votre cas respecte les règles de Paddle, par exemple vendre des abonnements à votre propre logiciel, elle peut être ajoutée en intégration sur mesure ou développée par vos équipes sur le code source inclus.

Paddle est un merchant of record conçu pour les logiciels, le SaaS et les produits numériques ; ce n'est donc généralement pas l'outil des vols, des hôtels ou des circuits. Vérifiez les règles d'utilisation acceptable de Paddle avant de l'employer pour des réservations de voyage ; la plupart des acteurs du voyage encaissent via une passerelle de paiement comme Stripe, PayPal, Adyen ou une passerelle régionale.

L'entreprise qui vend légalement au client. Elle est responsable de collecter et reverser la taxe de vente ou la TVA, d'émettre les factures, de gérer remboursements et rétrofacturations, et elle apparaît sur le relevé du client. Avec Paddle, c'est Paddle qui assume ce rôle puis vous verse les fonds.

Une passerelle traite les paiements pour vous, qui restez le vendeur et gardez le travail de taxe et de litiges. Paddle devient elle-même le vendeur, ce qui supprime ce travail pour les ventes de logiciels mais limite ce que vous pouvez vendre par son intermédiaire.

Quand vous vendez votre propre logiciel plutôt que des voyages : un outil de réservation, une API, un plugin ou un portail en marque blanche que les agences paient par abonnement. Paddle peut alors les facturer et gérer la taxe dans chaque pays.

Paddle envoie des événements, comme une transaction terminée ou un abonnement renouvelé, à une URL que vous enregistrez. Chaque requête porte un en-tête Paddle-Signature avec un horodatage et un hash, que votre serveur contrôle avec la clé secrète de l'endpoint avant d'agir.

Oui. Paddle propose un environnement sandbox distinct, avec son propre compte, ses clés API, ses prix et ses cartes de test. Développez et testez-y, puis reportez la configuration en production.

Oui, en deux flux séparés : le moteur de réservation encaisse les voyageurs via une passerelle prête à l'emploi, et Paddle facture les abonnements à votre logiciel. Gardez leurs écritures distinctes pour que chaque vente ait le bon traitement fiscal.

Continuez à explorer

Plus sur la plateforme