Novos Recursos
1. Cobrança Baseada em Créditos
Dodo Payments agora oferece Cobrança Baseada em Créditos, um sistema flexível para emitir, gerenciar e rastrear direitos a créditos em assinaturas, produtos avulsos e cobranças baseadas em uso. Em vez de cobrar por uso ou limitar acesso com flags de recurso, você distribui um conjunto de créditos que os clientes consomem à medida que usam seu serviço.
O Que Você Pode Fazer
| Capacidade | Descrição |
|---|
| Unidades Personalizadas ou Créditos Fiat | Defina créditos na sua própria unidade (chamadas de API, tokens, horas de computação) ou como valor em moeda corrente (USD, EUR) |
| Créditos por Assinatura | Emita créditos por ciclo de cobrança com reemissão automática na renovação |
| Créditos Únicos | Conceda um saldo fixo de créditos na compra, ideal para pacotes de recarga ou combos promocionais |
| Dedução Baseada em Uso | Vincule créditos a medidores para dedução automática com base em eventos de consumo em tempo real |
| Rollover | Permita que créditos não utilizados sejam transferidos, com porcentagem máxima, período e quantidade de rollovers configuráveis |
| Controles de Excesso | Deixe os clientes continuarem usando seu serviço além do saldo, com opções de perdoar, cobrar ou transportar o déficit |
| Expiração | Defina a validade dos créditos de 7 dias até nunca, com contagem personalizada de dias |
- Créditos Emitidos - Concedidos quando um cliente compra um produto com direitos a créditos anexados. Para assinaturas, os créditos são reemitidos a cada ciclo de cobrança.
- Créditos Consumidos - Deduzidos à medida que os clientes usam seu serviço. Medidores deduzem créditos automaticamente com base em eventos em tempo real, ou você pode deduzir manualmente pelo painel ou API.
- Créditos Expiram ou Rolam - Ao final do ciclo de cobrança (ou após o período de expiração configurado), os créditos não utilizados expiram ou rolam conforme suas configurações.
- Gerenciamento de Excesso - Se os créditos acabarem no meio do ciclo, você pode permitir o uso contínuo e escolher como lidar com o excesso ao final do ciclo.
Anexando Créditos a Produtos
Os créditos são anexados como direitos no fluxo de criação do produto. Você pode anexar até 3 créditos por produto, e eles funcionam com os três tipos de precificação: assinaturas, pagamentos únicos e cobrança baseada em uso.
// Create a checkout session for a product with attached credits
const session = await client.checkoutSessions.create({
product_cart: [
{
product_id: 'prod_ai_pro_plan',
quantity: 1,
}
],
customer: { email: 'customer@example.com' },
return_url: 'https://yourapp.com/success'
});
// Send usage events that deduct credits automatically
await fetch('https://api.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: `gen_${Date.now()}`,
customer_id: 'cus_abc123',
event_name: 'ai.generation',
timestamp: new Date().toISOString(),
metadata: { model: 'gpt-4', tokens: 1500 }
}]
})
});
| Evento | Descrição |
|---|
credit.added | Créditos concedidos a um cliente |
credit.deducted | Créditos consumidos por uso ou débito manual |
credit.expired | Créditos não utilizados expiraram |
credit.rolled_over | Créditos transferidos para uma nova concessão |
credit.rollover_forfeited | Créditos perdidos ao atingir o número máximo de rollovers |
credit.overage_charged | Cobranças por excesso aplicadas |
credit.manual_adjustment | Ajuste manual de crédito/débito realizado |
credit.balance_low | Saldo caiu abaixo do limite configurado |
Comece com configurações simples, sem rollover e sem excesso, e adicione complexidade à medida que entende como os clientes usam os créditos. A maioria das configurações pode ser atualizada a qualquer momento sem afetar concessões existentes.
2. Personalização de Design e Tema
Apresentamos a nova página de Design, um hub unificado para personalizar aparência e sensação do seu checkout, vitrine e portal do cliente a partir de um único local. Escolha temas pré-criados, configure tipografia e cores, e aplique substituições por seção, tudo com visualização ao vivo antes de salvar.
Principais Destaques
| Recurso | Descrição |
|---|
| Hub de Design Unificado | Configure a aparência do checkout, vitrine e portal do cliente em uma única página |
| Temas Pré-Construídos | Comece com um tema curado (Dodo Pulses, Terminal, Bumblebee ou Bubblegum) e personalize a partir daí |
| Modo Claro e Escuro | Defina paletas de cores separadas para cada modo |
| Visualização ao Vivo | Veja como suas alterações ficam no checkout, portal do cliente e vitrine antes de salvar |
| Substituições por Seção | Ajuste seções individuais sem afetar as demais |
| Controle Programático | Substitua temas no momento do checkout via API ou Checkout SDK |
| Aba | Propósito |
|---|
| Geral | Nome da empresa, logo, seleção de tema e configurações avançadas globais |
| Checkout | Substitua configurações de tema especificamente para a página de checkout |
| Vitrine | Substitua configurações de tema e configure o layout da vitrine |
| Portal do Cliente | Substitua configurações de tema para o portal do cliente |
- Dodo Pulses - Tema padrão com acentos verde-limão e tipografia sans-serif limpa
- Terminal - Voltado para desenvolvedores, com tipografia monoespaçada e acentos azul royal
- Bumblebee - Acentos âmbar e dourados quentes com estilo marcante e premium
- Bubblegum - Acentos em rosa e magenta divertidos com cantos totalmente arredondados
Após selecionar um tema pré-construído, você pode personalizar ainda mais propriedades individuais nas Configurações Avançadas. Qualquer propriedade não especificada volta aos padrões do tema.
3. Status de Reembolso e Disputa na API de Listagem de Pagamentos
O endpoint de listagem GET /payments agora inclui os campos refund_status e dispute_status em cada item de pagamento, para que você possa ver o estado de reembolso e disputa de relance, sem buscar detalhes individuais de pagamento.
| Campo | Tipo | Descrição |
|---|
refund_status | partial | full | null | Resumo do status de reembolso deste pagamento. null se nenhum reembolso bem-sucedido existir |
dispute_status | string | null | O status de disputa mais recente para este pagamento. null se não houver disputas |
dispute_status: dispute_opened, dispute_expired, dispute_accepted, dispute_cancelled, dispute_challenged, dispute_won, dispute_lost
Você também pode filtrar pagamentos por status de disputa usando o parâmetro de consulta dispute_status:
# List all payments with open disputes
curl -X GET 'https://api.dodopayments.com/payments?dispute_status=dispute_opened' \
-H 'Authorization: Bearer YOUR_API_KEY'
Use esses campos para criar painéis de disputa e reembolso, acionar alertas em alterações de status de disputa ou filtrar sua lista de pagamentos para exibir os que precisam de atenção.
4. Tabela de Reembolsos no Portal do Cliente
O Portal do Cliente agora inclui uma seção dedicada de Reembolsos, onde os clientes podem ver todos os reembolsos relacionados aos seus pagamentos. Cada entrada de reembolso mostra o valor, status, data e o pagamento original ao qual foi emitido, oferecendo transparência total do histórico de reembolsos sem precisar contatar o suporte.
A tabela de reembolsos está disponível automaticamente no portal do cliente para todas as empresas. Nenhuma configuração é necessária.
5. Copiar para o Modo Ao Vivo para Medidores
Agora você pode copiar medidores do modo de teste para o modo ao vivo diretamente do painel. Quando terminar de testar uma configuração de medidor no modo de teste, use a ação de cópia para replicá-la no modo ao vivo com todas as configurações preservadas: tipo de agregação, nome do evento, filtros e associações de créditos. Isso elimina a necessidade de recriar medidores manualmente ao migrar do desenvolvimento para a produção.
Construa e valide suas configurações de medidor primeiro no modo de teste, depois copie-as para o modo ao vivo quando estiver pronto para ir à produção. Isso garante que sua configuração de cobrança seja testada antes de lidar com uso real dos clientes.
