v1.97.6 (7 de mayo de 2026)

<Frame>
<img src="/images/entitlements/list.png" alt="Panel de Entitlements con la lista de entitlements a la izquierda y actividad de concesión a la derecha" style={{ maxHeight: '500px', width: 'auto' }} />
</Frame>

<Tip>
Para nuevas integraciones, escucha `entitlement_grant.delivered` en lugar de `payment.succeeded`. El éxito del pago no significa que la entrega haya terminado, especialmente para integraciones basadas en OAuth.
</Tip>

<Frame>
<img src="/images/customer-portal/cancellation-reasons.png" alt="Modal de cancelación del Portal del Cliente con el menú desplegable '¿Por qué estás cancelando?' mostrando razones como Demasiado caro, Faltan funciones y Otra" style={{ maxHeight: '500px', width: 'auto' }} />
</Frame>

// Reading the captured feedback
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

<Tip>
Combina `cancellation_feedback` con [Subscription Dunning](/features/recovery/subscription-dunning) para personalizar tus correos electrónicos de recuperación: por ejemplo, envía un código de descuento a los canceladores `too_expensive` y una encuesta de "¿qué falta?" a los canceladores `missing_features`.
</Tip>

// Per-subscription override
const subscription = await client.subscriptions.create({
  product_id: 'prod_inr_monthly',
  customer: { email: 'customer@example.in' },
  billing: { country: 'IN' /* ... */ },
  mandate_min_amount_inr_paise: 2_000_000 // ₹20,000 ceiling for this subscription
});

// Or via a checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_inr_monthly', quantity: 1 }],
  mandate_min_amount_inr_paise: 2_000_000,
  return_url: 'https://yoursite.com/return'
});

<Info>
Esta configuración solo afecta a los e-mandatos registrados para tarjetas emitidas en India (Visa, Mastercard, RuPay) en suscripciones INR. Las suscripciones UPI siguen su propio flujo de AutoPay y no se ven afectadas.
</Info>

const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override business default
  return_url: 'https://yoursite.com/return'
});

<Info>
Las transacciones INR → INR siempre se tratan como inclusivas independientemente de la configuración del negocio o sobrescribir por solicitud.
</Info>

<Tip>
Obtén el instalador más reciente para tu plataforma desde la [página de Releases de la Aplicación de Escritorio](https://github.com/dodopayments/dodo-desktop/releases/latest). El repositorio es completamente de código abierto.
</Tip>

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['crypto_currency', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});

<Info>
Los pagos con stablecoins son irreversibles por diseño: no hay devoluciones de cargo. Recomendamos ofrecer siempre `credit` e `debit` como métodos alternativos para clientes sin una billetera de stablecoin.
</Info>

const licenseKey = await client.licenseKeys.create({
  customer_id: 'cus_abc123',
  product_id: 'prod_456',
  key: 'YOUR-EXISTING-LICENSE-KEY',
  activations_limit: 5,
  expires_at: '2026-12-31T23:59:59Z',
});

<Warning>
Las claves de licencia creadas o actualizadas a través de la API no desencadenan notificaciones por correo electrónico a los clientes. Si necesitas notificar a los clientes sobre una clave importada, maneja eso por separado en tu aplicación.
</Warning>

<Tip>
¿Migrando desde Polar.sh o Lemon Squeezy? El [CLI `dodo-migrate`](/migrate-to-dodo) automatiza importaciones masivas de productos, clientes, descuentos y claves de licencia en un solo comando.
</Tip>

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
  feature_flags: {
    allow_phone_number_collection: true,
    require_phone_number: true
  },
  return_url: 'https://yoursite.com/return'
});

<Warning>
`require_phone_number: true` requiere `allow_phone_number_collection: true`. La API rechaza sesiones donde `require_phone_number` es verdadero mientras la recopilación de teléfonos está deshabilitada.
</Warning>

<Tip>
Útil para SaaS B2B, industrias reguladas o cualquier flujo donde necesites un canal de contacto verificado para soporte, revisión de fraude o cumplimiento.
</Tip>