Demo en vivo

Pagos para software de viajes

integración de la API de Paddle: cuándo encaja un merchant of record en un negocio de viajes

Paddle vende software, SaaS y productos digitales en tu nombre como merchant of record. Eso lo hace muy adecuado para una empresa de tecnología de viajes que cobra sus propias suscripciones, y normalmente la herramienta equivocada para cobrar vuelos, hoteles y tours. Esta página explica la diferencia, cómo funciona una integración con Paddle y cómo conectarlo a PHPTRAVELS cuando tu caso encaja.

  • Merchant of record, no pasarela
  • Pensado para software y suscripciones
  • Webhooks firmados
  • Conectado como integración a medida

Dos modelos distintos

Merchant of record frente a pasarela de pago

Una pasarela de pago mueve el dinero por ti: tú eres el vendedor, la empresa de pagos procesa la tarjeta y los impuestos, las facturas, los reembolsos y las disputas siguen siendo cosa tuya. Un merchant of record da un paso más y se convierte en el vendedor a ojos del cliente y de las autoridades fiscales. Cuando alguien compra a través de Paddle, Paddle le vende, cobra e ingresa el impuesto sobre las ventas o el IVA, emite la factura, gestiona los contracargos y después te paga tu parte.

Este modelo ahorra a una empresa de software mucho trabajo fiscal y de cumplimiento, pero también significa que Paddle decide qué está dispuesto a revender. Su plataforma está pensada para software, SaaS y productos digitales, no para servicios de viaje prestados por aerolíneas, hoteles y operadores turísticos. La mecánica general de los pagos con tarjeta se explica en la página de API de pasarela de pago.

Diagrama de un flujo de pago en el que un cliente paga en línea y las responsabilidades de pago, impuestos y liquidación pasan entre un vendedor y un proveedor de pagos
PreguntaPaddle (merchant of record)Pasarela de pago
¿Quién es el vendedor?Paddle es el vendedor registrado. El recibo y el cargo en la tarjeta del cliente proceden de Paddle.Tú eres el vendedor. La pasarela solo procesa el pago en tu cuenta de comercio.
¿Quién gestiona el impuesto sobre las ventas y el IVA?Paddle calcula, cobra e ingresa el impuesto sobre las ventas y el IVA en los lugares donde vende.Tú, con tus propios registros fiscales, tu asesor y tu facturación.
¿Quién emite la factura?Paddle emite la factura o el recibo al comprador.La emite tu propio sistema, por ejemplo la factura de reserva de tu panel de administración.
¿Quién gestiona los contracargos?Paddle se ocupa de las disputas y los contracargos como vendedor.Tú respondes a las disputas con pruebas desde el panel o la API de la pasarela.
¿Qué puedes vender?Software, SaaS, suscripciones y productos digitales, dentro de las normas de uso aceptable de Paddle.Ventas de productos y servicios que la pasarela apruebe, incluidas reservas de viaje para muchos comercios del sector.
¿Cómo cobras?Paddle te abona tus ingresos tras descontar sus comisiones, según su calendario de pagos.Los pagos capturados se liquidan en tu cuenta de comercio o bancaria, menos las comisiones de la pasarela.

Las comisiones, los países admitidos y la lista exacta de productos permitidos los fija Paddle y cambian con el tiempo. Consulta las condiciones de Paddle antes de contar con él.

Ayuda para decidir

¿Es Paddle adecuado para lo que vendes?

Parte de lo que paga el cliente. Elige el escenario más cercano a tu negocio.

01

Los viajeros pagan vuelos, hoteles y tours

El cliente compra un viaje que presta una aerolínea, un hotel o un operador turístico. Estos pagos suelen necesitar autorizar ahora y capturar después, reembolsos parciales tras los gastos de cancelación y un pago en varias divisas.

Nuestra opinión

Usa una pasarela de pago

Revisa las normas de uso aceptable de Paddle antes de usarlo para reservas de viaje. La mayoría de los negocios de viajes cobran las reservas con una pasarela de pago como Stripe, PayPal, Adyen o una pasarela regional.

02

Vendes tu propio software de viajes o SaaS

Eres un proveedor de tecnología de viajes y las agencias te pagan una suscripción mensual o anual por tu herramienta de reservas, el acceso a la API, un plugin o un portal de marca blanca.

Nuestra opinión

Paddle puede encajar

Es el tipo de venta para el que está hecho un merchant of record: Paddle factura la suscripción, gestiona el impuesto en cada país y te paga, de modo que no tienes que registrarte a efectos de IVA en todos los lugares donde están tus clientes.

03

Vendes reservas y software

Tu agencia gestiona un sitio de reservas para viajeros y además licencia su plataforma o sus herramientas a otras agencias.

Nuestra opinión

Usa ambos, por separado

Cobra las reservas con una pasarela lista para usar en el flujo de reserva y factura las suscripciones de software con Paddle. Dos flujos, dos registros, cada uno con el tratamiento fiscal correcto.

Cómo funciona

Cómo funciona una integración con Paddle, de principio a fin

Paddle Billing trabaja con productos y precios que creas en Paddle, un pago que abre Paddle.js y webhooks que avisan a tu servidor de lo ocurrido.

  1. 01

    Productos y precios

    Creas cada plan una sola vez en Paddle, por ejemplo un precio mensual y uno anual, y guardas los ID de precio en tu sistema.

    pri_…

  2. 02

    Pago con Paddle.js

    Tu página carga Paddle.js y abre el pago como superposición o marco integrado con el ID de precio y tu propia referencia de cliente.

    Paddle.Checkout.open()

  3. 03

    Transacción completada

    El comprador paga, Paddle cobra la tarjeta o el monedero, aplica el impuesto y crea una transacción, y una suscripción si el precio es recurrente.

    txn_…

  4. 04

    Webhook firmado

    Paddle envía a tu endpoint un evento como transaction.completed, firmado en la cabecera Paddle-Signature.

    transaction.completed

  5. 05

    Tu sistema actúa

    Tu servidor verifica la firma y después activa la cuenta, renueva el plan o registra el pago.

    200 OK

Guarda la clave de API solo en tu servidor. El navegador usa un token de cliente aparte, y los entornos sandbox y producción tienen cada uno sus claves, precios y secretos de webhook.

Seguridad de los webhooks

Comprobar la cabecera Paddle-Signature

Cualquiera que conozca la URL de tu endpoint puede falsificar un webhook. Verificar la firma de cada evento es lo que permite activar una cuenta a partir de un webhook con seguridad.

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

Ejemplo ilustrativo en PHP puro. Sigue la documentación actual de Paddle, o su SDK oficial, para el formato exacto.

  1. 01

    Usa el cuerpo sin procesar

    La firma se calcula sobre el cuerpo de la petición tal como llega, así que léelo antes de que cualquier análisis de JSON lo modifique.

  2. 02

    Marca de tiempo más hash

    La cabecera lleva una marca de tiempo y un hash HMAC-SHA256 generado con la clave secreta de tu endpoint. Reconstrúyelo y compáralo en tiempo constante.

  3. 03

    Rechaza eventos antiguos y repetidos

    Rechaza los eventos con una marca de tiempo demasiado antigua y guarda el ID de cada evento para que una entrega repetida no se procese dos veces.

  4. 04

    Primero el sandbox

    Desarrolla y prueba en el sandbox de Paddle con tarjetas de prueba y después cambia las claves, los precios y el secreto a producción.

PHPTRAVELS y Paddle

Conectar Paddle a PHPTRAVELS

Primero una respuesta honesta y después las opciones.

Paddle no es un conector listo para usar

Paddle no figura en la lista de pasarelas de pago de PHPTRAVELS y no tiene una guía de configuración publicada. Las pasarelas listas, que se muestran abajo, son las pensadas para cobrar reservas.

Consultar una integración a medidaProbar la demo de reservas

  • Para cobrar reservas: una pasarela lista para usar

    Activa en el panel de administración una pasarela lista como Pagos con Stripe o Pagos con PayPal con tu propia cuenta de comercio. El pago, los reembolsos y la referencia de la reserva ya están integrados en el flujo de reserva, como explica la página de Integración de pasarelas de pago.

  • Para vender software: Paddle como integración a medida

    Cuando tu caso encaja con las normas de Paddle, nuestros desarrolladores pueden conectarlo como Integración de API personalizada: pago con Paddle.js en tu página, un endpoint de webhook verificado y pagos registrados frente a tus clientes. El trabajo se presupuesta antes de empezar.

  • O constrúyelo tú sobre el código fuente

    PHPTRAVELS es de alojamiento propio e incluye todo su código fuente, así que tus propios desarrolladores pueden añadir Paddle para suscripciones junto al motor de reservas. La página de Precios indica qué incluye cada licencia.

Listas para cobrar reservas

Pasarelas de pago ya conectadas a PHPTRAVELS

Para los pagos de viajeros y agentes, estas pasarelas están listas: abres una cuenta con el proveedor, introduces tus claves en el panel de administración, pruebas y sales en producción. La lista es la actual de nuestro directorio de integraciones.

Los subagentes también pueden pagar con un saldo prepago o un límite de crédito a través del Monedero B2B para agentes, que no necesita ninguna pasarela.

Preguntas frecuentes

Integración de la API de Paddle: preguntas habituales

Habla con ventas

No como conector listo para usar. Paddle no figura en la lista de pasarelas de pago de PHPTRAVELS. Si tu caso encaja con las normas de Paddle, por ejemplo vender suscripciones de tu propio software, puede añadirse como integración a medida o construirse por tus desarrolladores sobre el código fuente incluido.

Paddle es un merchant of record pensado para software, SaaS y productos digitales, por lo que en general no es la herramienta para vuelos, hoteles o tours. Revisa las normas de uso aceptable de Paddle antes de usarlo para reservas de viaje; la mayoría de los negocios de viajes cobran las reservas con una pasarela de pago como Stripe, PayPal, Adyen o una pasarela regional.

La empresa que vende legalmente al cliente. Se encarga de cobrar e ingresar el impuesto sobre las ventas o el IVA, emitir facturas, gestionar reembolsos y contracargos, y aparece en el extracto del cliente. Con Paddle, Paddle asume ese papel y te paga.

Una pasarela procesa los pagos por ti mientras tú sigues siendo el vendedor y te quedas con el trabajo fiscal y las disputas. Paddle se convierte en el vendedor, lo que elimina ese trabajo en las ventas de software pero limita lo que puedes vender a través de él.

Cuando vendes tu propio software en lugar de viajes: una herramienta de reservas, una API, un plugin o un portal de marca blanca que las agencias pagan por suscripción. Paddle puede entonces facturarles y gestionar el impuesto en cada país.

Paddle envía eventos como una transacción completada o una suscripción renovada a una URL que registras. Cada petición lleva una cabecera Paddle-Signature con una marca de tiempo y un hash, que tu servidor comprueba con la clave secreta del endpoint antes de actuar.

Sí. Paddle tiene un entorno sandbox aparte, con su propia cuenta, claves de API, precios y tarjetas de prueba. Desarrolla y prueba ahí y después pasa la configuración al entorno de producción.

Sí, como dos flujos separados: el motor de reservas cobra a los viajeros con una pasarela lista para usar y Paddle factura tus suscripciones de software. Mantén sus registros separados para que cada venta reciba el tratamiento fiscal correcto.

Sigue explorando

Más sobre la plataforma