v1.75.0 (23 de enero de 2026)

Colecciones de productos, métodos de pago RevolutPay & Billie para pagos únicos en GBP, vista previa de la sesión de pago, metadatos en solicitudes de cambio de plan, campo invoice_url, endpoint de validación de descuentos y filtros mejorados del panel de control

​

Nuevas Funciones

​

1. Colecciones de Productos

Agrupa productos relacionados para experiencias de pago unificadas, selección de planes y caminos de actualización / degradación sin problemas dentro del Portal del Cliente.

Beneficios Clave

• Pago basado en colecciones: Muestra todos los productos de una colección en una vista de pago, permitiendo a los clientes comparar y elegir su plan preferido
• Gestión de productos organizada: Agrupa productos relacionados (por ejemplo, Starter, Pro, Enterprise) bajo una única colección
• Integración del Portal del Cliente: Permite a los clientes actualizar o degradar entre productos dentro de la misma colección
• Control del comerciante: Activar, desactivar y reordenar productos dentro de cada colección

Cómo Funciona

Crea una sesión de pago para una colección:

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;

Resultado: Una experiencia de pago unificada donde los clientes pueden ver y seleccionar todos los productos disponibles en tu colección.

Collection checkout es ideal para negocios de suscripción donde deseas que los clientes comparen los planes uno al lado del otro antes de comprar.

Aprende más: Guía de Colecciones de Productos

​

2. Métodos de Pago RevolutPay & Billie para Moneda GBP

Opciones de pago ampliadas con RevolutPay y Billie ahora disponibles globalmente para transacciones de pago único en GBP, ofreciendo a tus clientes más flexibilidad en la forma en que pagan.

Nuevos Métodos de Pago

Método de Pago	Países Soportados	Moneda	Soporte para Suscripciones
RevolutPay	Global	GBP	No (solo único)
Billie	Global	GBP	No (solo único)

• RevolutPay – Pagos rápidos y sin problemas para usuarios de Revolut en todo el mundo
• Billie – Solución B2B Compra Ahora, Paga Después que permite a las empresas ofrecer condiciones de pago flexibles a sus clientes

Estos métodos de pago están disponibles automáticamente para transacciones en GBP. No se requiere configuración adicional.

Aprende más: Métodos de Pago

​

3. Vista Previa de la Sesión de Pago

Vista previa de las sesiones de pago antes de crearlas para calcular precios, impuestos, descuentos y totales precisos. Muestra precios reales a los clientes antes de continuar al pago.

Cómo Funciona

const preview = await client.checkoutSessions.preview({
  product_cart: [
    { product_id: 'prod_123', quantity: 1 }
  ],
  billing_address: {
    country: 'US',
    state: 'CA',
    zipcode: '94102'
  },
  discount_code: 'SAVE20'
});

console.log('Subtotal:', preview.subtotal);
console.log('Tax:', preview.tax);
console.log('Discount:', preview.discount);
console.log('Total:', preview.total);

Casos de Uso

• Visualización de precios personalizados: Muestra totales precisos incluyendo impuestos antes del pago
• Validación de descuentos: Verifica códigos de descuento y muestra ahorros a los clientes
• Soporte multi-moneda: Previsualiza precios en diferentes monedas
• Resumen del carrito: Crea interfaces de carrito personalizadas con precios en tiempo real

Preview API Reference

Consulta la documentación completa del endpoint de vista previa.

​

4. Soporte de Metadatos en Solicitudes de Cambio de Plan

Envía metadatos personalizados al cambiar planes de suscripción, lo que permite un mejor seguimiento e integración con tus sistemas internos durante las transiciones de plan.

// Adding metadata when changing a subscription plan
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_premium',
  proration_billing_mode: 'prorated_immediately',
  quantity: 1,
  metadata: {
    upgrade_reason: 'feature_request',
    previous_plan: 'basic',
    sales_rep: '[e-mail]'
  }
});

Casos de Uso

• Rastrear razones de actualización / degradación: Almacena por qué los clientes cambiaron de plan
• Enlace a registros de CRM: Asocia cambios de plan con actividades de ventas
• Categoría interna: Etiqueta cambios de plan para informes y análisis
• Rastreo de auditoría: Mantén registros de quién inició cambios de plan

Los metadatos se incluyen en los eventos de webhook, lo que facilita procesar los cambios de plan con tus datos personalizados.

Aprende más: Guía de Metadatos | API de Cambio de Plan

​

5. invoice_url Campo en la respuesta de pago y en la respuesta del enlace de pago

La respuesta de pago y la respuesta del enlace de pago ahora incluyen un campo invoice_url, lo que proporciona acceso directo a la factura asociada con cada pago.

{
  "payment_id": "pay_2IjeQm4hqU6RA4Z4kwDee",
  "status": "succeeded",
  "invoice_url": "https://dodopayments.com/invoices/inv_2IsUnWGtRKFLxk7xAQeyt",
  "amount": 9900,
  "currency": "USD",
  // ... other fields
}

Casos de Uso

• Comunicación con el cliente: Envía enlaces de factura directamente a los clientes
• Integración contable: Vincula pagos a facturas en tu software contable
• Portales de autoservicio: Permite a los clientes acceder fácilmente a sus facturas
• Registro: Mantén referencias directas a documentos de factura

Get Payment API

Consulta el esquema de la respuesta de pago.

​

6. Endpoint de Validación de Descuento por Nombre de Código

Nuevo endpoint de API para validar y recuperar códigos de descuento por su nombre de código (por ejemplo, “SAVE20”) en lugar de usar la ID de descuento interna. Verifica la elegibilidad del descuento antes de aplicarlos en el pago.

// Validate a discount code before checkout
const discount = await client.discounts.getByCode('SAVE20');

console.log('Discount type:', discount.type);
console.log('Discount value:', discount.amount);
console.log('Valid until:', discount.expires_at);

Beneficios

• Validación previa al pago: Verifica códigos de descuento antes de crear sesiones de pago
• Retroalimentación en tiempo real: Muestra a los clientes si su código es válido
• Manejo de errores: Captura códigos inválidos o caducados temprano
• Interfaces de descuento personalizadas: Crea campos de entrada de código de descuento con validación instantánea

Get Discount by Code API

Consulta la documentación completa del endpoint.

​

7. Capacidades de Filtrado Mejoradas para Clientes, Descuentos y Claves de Licencia

Nuevos filtros de API para listar Clientes, Descuentos y Claves de Licencia, facilitando la búsqueda y gestión de tus datos programáticamente.

Filtros de API de Clientes

Filtro	Descripción
email	Filtrar por correo electrónico del cliente
name	Filtrar por nombre del cliente (coincidencia parcial, sin distinción entre mayúsculas y minúsculas)
created_at_gte	Filtrar clientes creados a partir de esta marca de tiempo
created_at_lte	Filtrar clientes creados en o antes de esta marca de tiempo

// Find customers by name created in the last 30 days
const customers = await client.customers.list({
  name: 'John',
  created_at_gte: '2026-01-01T00:00:00Z'
});

Filtros de API de Descuentos

Filtro	Descripción
code	Filtrar por código de descuento (coincidencia parcial, sin distinción entre mayúsculas y minúsculas)
discount_type	Filtrar por tipo de descuento (porcentaje)
active	Filtrar por estado activo (true = no caducado, false = caducado)
product_id	Filtrar por restricción de producto (solo descuentos que se aplican a este producto)

// Find active percentage discounts for a specific product
const discounts = await client.discounts.list({
  active: true,
  discount_type: 'percentage',
  product_id: 'prod_123'
});

Filtros de API de Claves de Licencia

Filtro	Descripción
customer_id	Filtrar por ID de cliente
status	Filtrar por estado de la clave de licencia (active, expired, disabled)
product_id	Filtrar por ID de producto
created_at_gte	Filtrar claves de licencia creadas a partir de esta marca de tiempo
created_at_lte	Filtrar claves de licencia creadas en o antes de esta marca de tiempo

// Find active license keys for a specific product
const licenseKeys = await client.licenseKeys.list({
  status: 'active',
  product_id: 'prod_123'
});

List Customers API

Consulta la documentación completa de la API de Clientes.

List Discounts API

Consulta la documentación completa de la API de Descuentos.

List License Keys API

Consulta la documentación completa de la API de Claves de Licencia.

​

8. Mejoras en UI/UX en el Panel de Control

Esta versión incluye numerosas mejoras en UI/UX a través del panel de control para una experiencia más intuitiva y pulida.

Aspectos Destacados

• Mejora de la navegación y consistencia de diseño
• Interacciones mejoradas en tablas de datos
• Mejores estados de carga y retroalimentación
• Elementos de diseño visual refinados
• Mejor respuesta a dispositivos móviles