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. Códigos de Desconto Empilhados
Sessões de checkout, pagamentos, assinaturas e mudanças de plano agora aceitam até 20 códigos de desconto em uma única solicitação via o array discount_codes. Os códigos são aplicados na ordem do array — o primeiro código elegível reduz o preço base, o segundo reduz o preço já com desconto, e assim por diante — para que você possa sobrepor campanhas sem criar códigos combinados personalizados.
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| Superfície | Campo | Máx. de códigos |
|---|
| Sessões de Checkout | discount_codes | 20 |
| Pagamentos | discount_codes | 20 |
| Assinaturas | discount_codes | 20 |
| Mudanças de Plano | discount_codes | 20 |
Valor discount_codes | Efeito |
|---|
| Não fornecido | Descontos existentes com preserve_on_plan_change=true são mantidos se aplicáveis ao novo produto |
[] (array vazio) | Todos os descontos existentes são removidos da assinatura |
['CODE_A', 'CODE_B', ...] | Substitui qualquer desconto existente com este conjunto empilhado, aplicado na ordem do array |
discounts em pagamentos e assinaturas — cada entrada inclui discount_id, position, e cycles_remaining (para assinaturas). O campo singular legado discount_id está obsoleto, mas ainda presente para compatibilidade retroativa.
O campo singular discount_code está obsoleto, mas ainda é totalmente suportado — integrações existentes continuam a funcionar sem mudanças. Não pode ser combinado com discount_codes na mesma solicitação. Recomendamos migrar para discount_codes quando conveniente, mesmo para códigos únicos, para aproveitar o empilhamento e o formato de resposta mais rico.
2. Sete Novos E-mails de Notificação ao Cliente
Sete novos e-mails transacionais são agora enviados automaticamente aos seus clientes, cobrindo confirmações de reembolso, marcos do ciclo de vida da assinatura e falhas de pagamento. Cada e-mail pode ser alternado independentemente em Configurações → Comunicação na seção E-mails do Cliente.
Opt-in (ativado por padrão)
| E-mail | Quando é acionado |
|---|
| Reembolso Bem-sucedido | Um reembolso é processado com sucesso e os fundos estão a caminho de volta para o cliente |
| Fim do Período de Avaliação da Assinatura | ~2 dias antes de um período de avaliação expirar e ocorrer a primeira cobrança |
| Assinatura Cancelada Imediatamente | Uma assinatura é cancelada com efeito imediato |
| Assinatura Programada para Cancelar na Próxima Data de Cobrança | Uma assinatura está programada para cancelar no final do período de cobrança atual |
| E-mail | Quando é acionado |
|---|
| Falha no Pagamento | Uma tentativa de pagamento falhou — ative se você deseja que o Dodo Payments notifique o cliente diretamente ao invés de lidar com isso no seu próprio sistema |
| Falha na Renovação da Assinatura | Um pagamento de renovação de assinatura falha especificamente; é acionado em vez de (e não junto com) o e-mail geral de Falha de Pagamento para renovações |
| Lembrete de Renovação Próxima | ~2 dias antes de uma assinatura renovar |
Se você gerencia a comunicação com o cliente via webhooks, deixe os e-mails de opt-out desativados para evitar enviar notificações duplicadas para o mesmo evento.
Os e-mails de clientes são separados dos e-mails de notificação enviados para sua equipe. Desativar um e-mail de cliente não afeta as notificações da sua equipe para o mesmo evento.
3. Sunbit — Financiamento Parcelado para Clientes dos EUA
Sunbit agora está disponível como método de pagamento Compre Agora, Pague Depois, permitindo que clientes dos EUA dividam compras em parcelas mensais gerenciáveis no checkout.
| Recurso | Detalhes |
|---|
| Disponibilidade | Estados Unidos |
| Moeda | USD |
| Quantidade mínima | $60.00 |
| Quantidade máxima | $19,999.00 |
| Assinaturas | Não suportado (apenas pagamentos únicos) |
sunbit em allowed_payment_method_types para ativá-lo em uma sessão de checkout:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
Sempre inclua credit e debit como alternativas. Nem todos os clientes se qualificarão para o financiamento Sunbit, e transações fora da faixa de 60.00–19,999.00 não exibirão a opção. Melhorias
A página de pagamento no checkout foi substancialmente reformulada de ponta a ponta — layout mais compacto, carregamento percebido mais rápido, estados de validação mais claros e UX refinado de entrada de cartão. No agregado, essas mudanças aumentaram as taxas de sucesso do checkout em ~2–3% no tráfego global.
O que mudou:
- Interações de campo mais suaves — foco automático, ordem de tabulação mais inteligente e navegação por teclado aprimorada no formulário de cartão
- Estados de erro e carregamento mais limpos — a validação inline aparece precisamente onde o cliente precisa agir, substituindo o padrão anterior de banner de erro de formulário completo
- Pintura mais rápida — esqueleto e hidratação progressiva eliminam o breve piscar de estado em branco em redes lentas
- Aprimoramento móvel — alvos de toque, comportamento de rolagem e manuseio de teclado ajustados especificamente para checkout móvel, onde agora ocorre a maioria do tráfego
Não são necessárias mudanças de integração. Sessões de checkout existentes captam automaticamente a nova página de pagamento.
- Visualização ao vivo — veja como seu produto aparece no checkout e portal do cliente enquanto edita, lado a lado com o formulário
- Salvamento automático — os rascunhos são salvos automaticamente, então navegar ou perder a aba não significa mais perder seu trabalho
- Editor Markdown — descrições de produtos agora suportam um editor markdown completo com renderização ao vivo, pré-visualização de links e controles de formatação inline
- Paridade do fluxo de duplicação — duplicar um produto abre o mesmo formulário unificado pré-preenchido, em vez de um diálogo resumido, para que você possa ajustar cada campo antes de salvar a cópia
Use Duplicar para criar variantes regionais ou de nível de preço de um produto existente sem reintroduzir descrições, metadados ou configuração de cumprimento.
6. Redesign da Página de Configurações de Negócios
A página Configurações → Negócios foi redesenhada para tornar a configuração mais fácil de escanear e mais rápida de atualizar. As configurações agora estão agrupadas em seções mais claras com textos explicativos que descrevem o impacto de cada alternância antes de você ativá-la.
Não há mudanças comportamentais nas configurações existentes — apenas o layout, agrupamento e explicações ao redor foram melhorados.
Melhorias
credits_amount agora propagado corretamente para rotas GET de sessão de checkout e links de pagamento — quando uma sessão de checkout ou link de pagamento era criado com uma substituição credit_entitlements por checkout, buscar essa sessão ou link via GET estava retornando o padrão de produto credits_amount em vez do valor substituído. Isso agora foi corrigido.- Ação de reembolso desabilitada para pagamentos totalmente reembolsados — o botão de reembolso em um pagamento agora está desabilitado uma vez que o pagamento foi totalmente reembolsado, com uma dica explicando o motivo. Anteriormente, o botão permanecia ativo e retornava um erro apenas após a submissão.
- Correções de bugs menores e melhorias de estabilidade em toda a plataforma.
