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. Recuperação de Carrinhos Abandonados
Detecte automaticamente checkouts incompletos ou falhos e envie sequências de e-mails direcionados para trazer os clientes de volta. ACR monitora pagamentos que não foram concluídos após 60 minutos e os classifica como pagamento falhou ou checkout incompleto, então envia até 3 e-mails de recuperação configuráveis por sequência.
Principais capacidades:
- Duas sequências de e-mail — Pagamento Falhou e Checkout Incompleto, cada uma com até 3 e-mails
- Descontos de recuperação — Opcionalmente, gere códigos de desconto de uso único para incentivar a recuperação
- Página de recuperação do cliente — Links de recuperação únicos levam os clientes a uma página dedicada para completar a compra
- Análises de recuperação — Acompanhe contagens de checkout abandonado, taxas de recuperação, receita recuperada e detalhamentos por e-mail/produto
Comece com o tempo padrão de envio de e-mails (1 hora, 24 horas, 72 horas) e itere com base nos dados das suas análises de recuperação.
2. Dunning de Assinaturas
Envie automaticamente sequências de e-mails para recuperar assinaturas vencidas ou canceladas. O Dunning é acionado quando uma assinatura entra em em espera (falha de pagamento) ou é cancelada pelo cliente no portal do cliente.
Principais capacidades:
- Duas sequências de e-mail — Em Espera e Cancelada, cada uma com até 4 e-mails
- Cobrança automática — Quando um cliente atualiza seu método de pagamento, dívidas pendentes são cobradas automaticamente
- Tempo configurável — Intervalos padrão de 1, 3, 5 e 7 dias, totalmente personalizáveis por e-mail
Saiba mais: Dunning de Assinaturas
Agora você pode anexar metadados (pares chave-valor) a descontos ao criá-los ou atualizá-los via API. Use metadados para marcar descontos por campanha, origem ou referência interna para acompanhamento e reconciliação.
const discount = await client.discounts.create({
type: 'percentage',
amount: 1500, // 15%
code: 'SUMMER2025',
metadata: {
campaign: 'summer_promo',
source: 'email_blast'
}
});
4. Webhooks de Recuperação
Novos eventos de webhook para acompanhar o ciclo de vida da recuperação:
| Evento | Descrição |
|---|
abandoned_checkout.detected | Um checkout abandonado foi detectado |
abandoned_checkout.recovered | Cliente completou o pagamento através de um link de recuperação |
dunning.started | Uma tentativa de dunning foi iniciada para uma assinatura |
dunning.recovered | Cliente atualizou o método de pagamento e o pagamento foi bem-sucedido |
5. Pagamentos Pix para o Brasil
Aceite Pix — o sistema de pagamento instantâneo do Brasil criado pelo Banco Central do Brasil — no checkout do seu Dodo Payments. O Pix agora é o método de pagamento mais usado no Brasil, superando tanto os cartões de crédito quanto o boleto, e confirma em segundos 24/7/365.
Cobertura
| Detalhe | Valor |
|---|
| Moeda de faturamento | BRL |
| Países suportados | Brasil |
| Assinaturas | Não suportado (somente pagamentos únicos) |
| Quantia mínima | $0,50 |
| Liquidação | Instantânea |
pix em allowed_payment_method_types e defina a moeda de faturamento para BRL:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['pix', 'credit', 'debit'],
billing_currency: 'BRL',
return_url: 'https://example.com/success'
});
Os códigos QR Pix expiram após um período definido — projete seu fluxo de checkout para permitir que os clientes regenerem o código, se necessário. Sempre inclua opções com cartão para clientes que preferem pagar com cartão.
6. WeChat Pay para Clientes Chineses
Aceite WeChat Pay — usado por mais de um bilhão de pessoas em toda a China — diretamente no checkout do seu Dodo Payments. Os clientes escaneiam um código QR com o aplicativo WeChat e confirmam o pagamento em segundos, tudo sem sair do ecossistema WeChat.
Cobertura
| Detalhe | Valor |
|---|
| Moedas de faturamento | USD, CNY |
| Assinaturas | Não suportado (somente pagamentos únicos) |
| Quantia mínima | $0,50 / ¥1,00 |
| Liquidação | USD |
wechat_pay em allowed_payment_method_types ao criar uma sessão de checkout:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['wechat_pay', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
Exiba o checkout em um desktop ou tablet para que os clientes possam escanear o código QR com o telefone — este é o fluxo mais familiar para os usuários do WeChat Pay.
