Demo live

Pagamenti per software di viaggio

Integrazione API Paddle: quando un merchant of record è adatto a un'attività di viaggi

Paddle vende software, SaaS e prodotti digitali per tuo conto, come merchant of record. È quindi una scelta solida per un'azienda di tecnologia per il turismo che fattura i propri abbonamenti, e di solito lo strumento sbagliato per incassare voli, hotel e tour. Questa pagina spiega la differenza, come funziona un'integrazione Paddle e come collegarla a PHPTRAVELS quando il tuo caso lo permette.

  • Merchant of record, non un gateway
  • Pensata per software e abbonamenti
  • Webhook firmati
  • Collegata come integrazione personalizzata

Due modelli diversi

Merchant of record e gateway di pagamento

Un gateway di pagamento muove il denaro per te: il venditore sei tu, la società di pagamenti elabora la carta, e imposte, fatture, rimborsi e contestazioni restano a tuo carico. Un merchant of record fa un passo in più e diventa il venditore agli occhi del cliente e del fisco. Quando qualcuno compra con Paddle, è Paddle a vendere, incassare e versare l'imposta sulle vendite o l'IVA, emettere la fattura, gestire i chargeback e poi pagarti la tua quota.

Questo modello risparmia a un'azienda software un lavoro enorme di fiscalità e conformità, ma significa anche che è Paddle a decidere cosa accetta di rivendere. La piattaforma è pensata per software, SaaS e prodotti digitali, non per servizi di viaggio erogati da compagnie aeree, hotel e tour operator. Il funzionamento generale dei pagamenti con carta è nella pagina API gateway di pagamento.

Schema di un flusso di pagamento in cui un cliente paga online mentre le responsabilità di pagamento, imposte e accredito passano tra un venditore e un fornitore di pagamenti
DomandaPaddle (merchant of record)Gateway di pagamento
Chi è il venditore?Paddle è il venditore ufficiale. Ricevuta ed estratto conto del cliente provengono dal lato Paddle della vendita.Il venditore sei tu. Il gateway si limita a elaborare il pagamento sul tuo conto merchant.
Chi gestisce imposta sulle vendite e IVA?Paddle calcola, incassa e versa imposta sulle vendite e IVA nei luoghi in cui vende.Tu, con le tue registrazioni fiscali, il tuo commercialista e la tua fatturazione.
Chi emette la fattura?Paddle emette fattura o ricevuta all'acquirente.La emette il tuo sistema, ad esempio la fattura della prenotazione nel tuo admin.
Chi gestisce i chargeback?Paddle si occupa di contestazioni e chargeback come venditore.Rispondi tu alle contestazioni con le prove, dalla dashboard o dall'API del gateway.
Cosa puoi vendere?Software, SaaS, abbonamenti e prodotti digitali, nel rispetto delle regole d'uso accettabile di Paddle.Vendite di beni e servizi approvate dal gateway, comprese le prenotazioni di viaggio per molti merchant del settore.
Come vieni pagato?Paddle ti accredita i guadagni al netto delle commissioni, secondo il proprio calendario dei pagamenti.I pagamenti acquisiti vengono accreditati sul tuo conto merchant o bancario, meno le commissioni del gateway.

Commissioni, paesi supportati ed elenco esatto dei prodotti consentiti sono stabiliti da Paddle e cambiano nel tempo. Consulta i termini di Paddle prima di fare affidamento su di essa.

Aiuto alla decisione

Paddle è adatta a ciò che vendi?

Parti da ciò che il cliente sta pagando. Scegli lo scenario più vicino alla tua attività.

01

I viaggiatori pagano voli, hotel e tour

Il cliente acquista un viaggio erogato da una compagnia aerea, un hotel o un tour operator. Questi pagamenti richiedono spesso autorizzazione subito e cattura dopo, rimborsi parziali dopo le penali di cancellazione e checkout multivaluta.

Il nostro parere

Usa un gateway di pagamento

Verifica le regole d'uso accettabile di Paddle prima di usarla per le prenotazioni di viaggio. La maggior parte delle attività di viaggio incassa le prenotazioni con un gateway di pagamento come Stripe, PayPal, Adyen o un gateway regionale.

02

Vendi il tuo software di viaggio o SaaS

Sei un fornitore di tecnologia per il turismo e le agenzie ti pagano un abbonamento mensile o annuale per il tuo strumento di prenotazione, l'accesso alle API, un plugin o un portale white label.

Il nostro parere

Paddle può andare bene

È il tipo di vendita per cui nasce un merchant of record: Paddle fattura l'abbonamento, gestisce le imposte di ogni paese e ti accredita il ricavato, senza che tu debba registrarti all'IVA ovunque si trovino i tuoi clienti.

03

Vendi prenotazioni e software

La tua agenzia gestisce un sito di prenotazione per i viaggiatori e concede in licenza la piattaforma o gli strumenti ad altre agenzie.

Il nostro parere

Usa entrambi, separati

Incassa le prenotazioni con un gateway già pronto nel flusso di prenotazione e fattura gli abbonamenti software tramite Paddle. Due flussi, due serie di registri, ciascuno con il giusto trattamento fiscale.

Come funziona

Come funziona un'integrazione Paddle, da capo a fondo

Paddle Billing lavora con prodotti e prezzi creati in Paddle, un checkout aperto da Paddle.js e webhook che informano il tuo server su quanto è accaduto.

  1. 01

    Prodotti e prezzi

    Crei ogni piano una sola volta in Paddle, ad esempio un prezzo mensile e uno annuale, e conservi gli ID dei prezzi nel tuo sistema.

    pri_…

  2. 02

    Checkout Paddle.js

    La tua pagina carica Paddle.js e apre il checkout come overlay o frame integrato, con l'ID del prezzo e il tuo riferimento cliente.

    Paddle.Checkout.open()

  3. 03

    Transazione completata

    L'acquirente paga, Paddle addebita carta o wallet, applica l'imposta e crea una transazione, più un abbonamento se il prezzo è ricorrente.

    txn_…

  4. 04

    Webhook firmato

    Paddle invia al tuo endpoint un evento come transaction.completed, firmato nell'header Paddle-Signature.

    transaction.completed

  5. 05

    Il tuo sistema agisce

    Il tuo server verifica la firma, poi attiva l'account, rinnova il piano o registra il pagamento.

    200 OK

Tieni la chiave API solo sul server. Il browser usa un token lato client separato, e gli ambienti sandbox e live hanno ciascuno chiavi, prezzi e segreti webhook propri.

Sicurezza dei webhook

Verificare l'header Paddle-Signature

Un webhook può essere falsificato da chiunque conosca l'URL del tuo endpoint. Verificare la firma di ogni evento è ciò che rende sicuro attivare un account a partire da un webhook.

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

Esempio illustrativo in PHP puro. Per il formato esatto segui la documentazione attuale di Paddle o il suo SDK ufficiale.

  1. 01

    Usa il corpo grezzo

    La firma è calcolata sul corpo della richiesta esattamente come ricevuto, quindi leggilo prima che qualsiasi parsing JSON lo modifichi.

  2. 02

    Timestamp più hash

    L'header contiene un timestamp e un hash HMAC-SHA256 generato con la chiave segreta dell'endpoint. Ricostruiscilo e confronta in tempo costante.

  3. 03

    Scarta eventi vecchi e ripetuti

    Rifiuta gli eventi con timestamp troppo vecchio e salva l'ID di ogni evento, così una consegna ripetuta non viene elaborata due volte.

  4. 04

    Prima la sandbox

    Sviluppa e prova nella sandbox di Paddle con carte di test, poi passa chiavi, prezzi e segreto all'ambiente live.

PHPTRAVELS e Paddle

Collegare Paddle a PHPTRAVELS

Prima una risposta onesta, poi le opzioni.

Paddle non è un connettore pronto

Paddle non è nell'elenco dei gateway di pagamento di PHPTRAVELS e non ha una guida di configurazione pubblicata. I gateway pronti, mostrati sotto, sono quelli pensati per incassare le prenotazioni.

Chiedi di un'integrazione personalizzataProva la demo di prenotazione

  • Per i pagamenti delle prenotazioni: un gateway pronto

    Attiva nell'admin un gateway pronto come Pagamenti Stripe o Pagamenti PayPal con il tuo conto merchant. Checkout, rimborsi e riferimento della prenotazione sono già integrati nel flusso di prenotazione, come spiega la pagina Integrazione gateway di pagamento.

  • Per la vendita di software: Paddle come integrazione personalizzata

    Quando il tuo caso rientra nelle regole di Paddle, i nostri sviluppatori possono collegarla come Integrazione API personalizzata: checkout Paddle.js sulla tua pagina, endpoint webhook verificato e pagamenti registrati sui tuoi clienti. Il lavoro viene preventivato prima di iniziare.

  • Oppure costruiscila tu sul codice sorgente

    PHPTRAVELS è self-hosted e include il codice sorgente completo, quindi i tuoi sviluppatori possono aggiungere Paddle per gli abbonamenti accanto al motore di prenotazione. La pagina Prezzi elenca cosa include ogni licenza.

Pronti per i pagamenti delle prenotazioni

Gateway di pagamento già collegati a PHPTRAVELS

Per i pagamenti di viaggiatori e agenti questi gateway sono pronti: apri un conto presso il provider, inserisci le chiavi nell'admin, provi e vai in produzione. L'elenco è quello aggiornato della nostra directory delle integrazioni.

I sub-agenti possono anche pagare con un saldo prepagato o un fido tramite il Wallet B2B per agenti, che non richiede alcun gateway.

FAQ

Integrazione API Paddle: domande frequenti

Contatta il team vendite

Non come connettore pronto. Paddle non è nell'elenco dei gateway di pagamento di PHPTRAVELS. Se il tuo caso rientra nelle regole di Paddle, ad esempio vendere abbonamenti al tuo software, può essere aggiunta come integrazione personalizzata o realizzata dai tuoi sviluppatori sul codice sorgente incluso.

Paddle è un merchant of record pensato per software, SaaS e prodotti digitali, quindi in genere non è lo strumento per voli, hotel o tour. Verifica le regole d'uso accettabile di Paddle prima di usarla per le prenotazioni di viaggio; la maggior parte delle attività di viaggio incassa con un gateway di pagamento come Stripe, PayPal, Adyen o un gateway regionale.

L'azienda che vende legalmente al cliente. È responsabile di incassare e versare l'imposta sulle vendite o l'IVA, emettere fatture, gestire rimborsi e chargeback, e compare sull'estratto conto del cliente. Con Paddle è Paddle a ricoprire questo ruolo e poi a pagarti.

Un gateway elabora i pagamenti per te, che resti il venditore e mantieni il lavoro su imposte e contestazioni. Paddle diventa essa stessa il venditore, il che elimina quel lavoro per le vendite di software ma limita ciò che puoi vendere tramite lei.

Quando vendi il tuo software e non i viaggi: uno strumento di prenotazione, un'API, un plugin o un portale white label che le agenzie pagano in abbonamento. Paddle può allora fatturarli e gestire le imposte in ogni paese.

Paddle invia eventi, come una transazione completata o un abbonamento rinnovato, a un URL che registri. Ogni richiesta porta un header Paddle-Signature con timestamp e hash, che il tuo server controlla con la chiave segreta dell'endpoint prima di agire.

Sì. Paddle ha un ambiente sandbox separato, con account, chiavi API, prezzi e carte di test propri. Sviluppa e prova lì, poi sposta la configurazione nell'ambiente live.

Sì, come due flussi separati: il motore di prenotazione incassa i pagamenti dei viaggiatori tramite un gateway pronto e Paddle fattura gli abbonamenti al tuo software. Tieni distinti i registri, così ogni vendita ha il giusto trattamento fiscale.

Continua a esplorare

Altro sulla piattaforma