v1.97.6 (7 de maio de 2026)

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Novos Recursos

​

1. Entitlements

​

2. Motivos de Cancelamento de Assinatura no Portal do Cliente

• Objeto de assinatura: Novo campo cancellation_feedback (um dos valores acima) e cancellation_comment (texto livre opcional), preenchido quando o cliente cancela
• subscription.cancelled webhook: Ambos os campos estão incluídos no payload
• API: Passe cancellation_feedback e cancellation_comment para PATCH /subscriptions/{id} ao programar ou executar um cancelamento programaticamente

// 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"

​

3. Valor Mínimo de Mandato Configurável para E-Mandatos em INR

// 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'
});

1. Substituição por solicitação (mandate_min_amount_inr_paise na sessão de checkout, pagamento ou assinatura)
2. Configuração a nível de comerciante nas configurações de negócios
3. Padrão do sistema de ₹15.000 (1.500.000 paise)

​

4. Configuração de Negócios com Taxas Inclusivas para Moeda Adaptativa

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

​

5. Aplicativo Desktop Dodo Payments

• Binário nativo pequeno — construído com Tauri no webview nativo do sistema, total de ~5 MB (sem Chromium incluído)
• Assinado e notariado — as versões para macOS são assinadas com ID de Desenvolvedor Apple e notariadas, sem alertas do Gatekeeper
• Autoatualização — verifica a cada 4 horas e aplica atualizações assinadas automaticamente do GitHub Releases (funciona em macOS, Windows e Linux AppImage)
• Bandeja do sistema + menu de barra — esconder na bandeja no macOS, menus completos Arquivo/Editar/Visualizar/Ajuda com atalhos de teclado (⌘⇧H vá para o painel, ⌘L copie a URL atual, ⌘⌥I ferramentas de desenvolvimento)
• Suporte a deep-link — links de autenticação mágicos abrem diretamente no app
• Multi-janela — abra múltiplos painéis lado a lado

​

6. Pagamentos Stablecoin (USDC, USDP, USDG)

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

​

7. Importar Chaves de Licença Existentes

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',
});

​

8. require_phone_number para Sessões de Checkout

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

​

Correções de Bugs e Melhorias

• Correções de bugs menores e melhorias de estabilidade em toda a plataforma