Saltar al contenido principal

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.
Página de pago de la Colección de Productos mostrando múltiples opciones de plan
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 entre todos los productos disponibles en tu colección.
El pago por colección es ideal para negocios por suscripción donde deseas que los clientes comparen 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 PagoPaíses SoportadosMonedaSoporte para Suscripciones
RevolutPayGlobalGBPNo (solo único)
BillieGlobalGBPNo (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 automáticamente disponibles 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

Referencia de API de Vista Previa

Ver 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: 'john@company.com'
  }
});
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 eventos de webhook, facilitando el procesamiento de 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 Respuesta de Enlace de Pago

La Respuesta de Pago y la Respuesta de Enlace de Pago ahora incluyen un campo invoice_url, proporcionando 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

Obtener API de Pago

Ver el esquema de 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

Obtener Descuento por Código API

Ver 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
FiltroDescripción
emailFiltra por email del cliente
nameFiltra por nombre del cliente (coincidencia parcial, sin distinción de mayúsculas)
created_at_gteFiltra clientes creados en o después de esta marca de tiempo
created_at_lteFiltra 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
FiltroDescripción
codeFiltra por código de descuento (coincidencia parcial, sin distinción de mayúsculas)
discount_typeFiltra por tipo de descuento (porcentaje)
activeFiltra por estado activo (verdadero = no caducado, falso = caducado)
product_idFiltra 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
FiltroDescripción
customer_idFiltra por ID de cliente
statusFiltra por estado de clave de licencia (active, expired, disabled)
product_idFiltra por ID de producto
created_at_gteFiltra claves de licencia creadas en o después de esta marca de tiempo
created_at_lteFiltra 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'
});

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