Facturación de Paddle: Configuración y Eventos de Pago

Lo que Paddle maneja

Paddle actúa como Comerciante de Registro para transacciones elegibles procesadas a través de Paddle. Sus servicios de impuestos y facturación se aplican a esas transacciones bajo tu acuerdo con Paddle; conectar una pasarela no hace que cada parte de un negocio cumpla con las normativas en cada jurisdicción.

Antes de la configuración

• Completa la aprobación de cuenta y producto requerida por Paddle.
• Utiliza la integración actual de Facturación de Paddle, no credenciales ni nombres de eventos de Paddle Classic.
• Prepara credenciales separadas para sandbox y producción. Mantén las claves API y secretos de webhook en el servidor.

Conectar la pasarela

1. Abre la configuración de la pasarela de pago en el administrador y selecciona Paddle.
2. Ingresa las credenciales API y del lado del cliente solicitadas por el formulario actual, junto con el secreto de firma del webhook.
3. Selecciona el entorno de sandbox para pruebas. Nunca mezcles un token de sandbox con una clave API de producción.
4. En Paddle, crea el destino de notificación para el endpoint de webhook de tu instalación de Paddle.

El endpoint utilizado por esta integración es https://your-store.example/api/payment/webhooks/paddle. Confirma la ruta real para tu versión instalada antes de configurarla.

Usar eventos de facturación actuales

La facturación de Paddle utiliza nombres de eventos con puntos. La finalización de pago se informa con transaction.completed; las suscripciones utilizan eventos como subscription.created y subscription.updated. Selecciona los eventos manejados por tu controlador instalado. No utilices una lista antigua de Classic como payment_succeeded.

Verifica antes de ir a producción

Completa un checkout en sandbox, verifica su estado de pedido y transacción, y confirma que el webhook firmado es aceptado. Para productos recurrentes, prueba la creación, una renovación y cancelación. Una notificación duplicada no debe crear un segundo cumplimiento o cargo.

La aprobación de la pasarela, productos soportados, monedas, impuestos y términos de pago provienen de Paddle. Revisa su documentación actual: Webhooks de Facturación de Paddle.

Solución de problemas

Para una falla de autenticación, verifica el entorno y las credenciales. Para una falla de firma, revisa el secreto de destino y el endpoint. Para un pedido pendiente, inspecciona su estado de pago y webhook antes de volver a intentar. No envíes una clave secreta en un ticket de soporte.