> ## 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.
# v1.86.0 (2 de março de 2026)
> Cobrança baseada em créditos com rollover, excessos e controles de expiração, hub unificado de design e personalização de temas, status de reembolso e disputa na API de listagem de pagamentos, tabela de reembolsos no portal do cliente e copiar para modo ao vivo para medidores
## 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 |
**Ciclo de Vida dos Créditos**
1. **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.
2. **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.
3. **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.
4. **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.
```typescript theme={null}
// 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'
});
```
**Dedução Baseada em Uso**
Quando créditos são vinculados a medidores, o sistema deduz automaticamente conforme eventos de uso são ingeridos. Configure a taxa de **unidades do medidor por crédito** para controlar a conversão (ex: 1.000 chamadas de API = 1 crédito).
```typescript theme={null}
// Send usage events that deduct credits automatically
await fetch('https://test.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 }
}]
})
});
```
**Experiência do Cliente**
Os clientes podem visualizar e gerenciar seus saldos de crédito no **Portal do Cliente** na seção Créditos, com saldo disponível, histórico de transações e detalhamento de uso. Os créditos também aparecem no checkout, nos detalhes da assinatura e nas páginas de transação de pagamento.
**Webhooks**
A Cobrança Baseada em Créditos dispara eventos de webhook para cada alteração do ciclo de vida dos créditos:
| 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.
Saiba mais: [Cobrança Baseada em Créditos](/features/credit-based-billing) | [Payloads de Webhook de Crédito](/developer-resources/webhooks/intents/credit) | [API de Direitos a Créditos](/api-reference/credit-entitlements/create-credit-entitlement)
### 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 |
**Primeiros Passos**
Navegue até **Design** no menu principal do seu Painel do Comerciante. A página possui quatro abas:
| 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 |
**Configurações Avançadas**
Expanda Configurações Avançadas na aba Geral para controle granular sobre tipografia (Google Fonts primária/secundária, tamanho da fonte, peso da fonte), configuração de cores (paletas separadas para modo claro e escuro cobrindo fundos, textos, botões e bordas) e raio de borda para controlar o arredondamento dos elementos da interface.
**Temas Pré-Construídos**
Quatro temas curados são fornecidos por padrão:
* **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.
Saiba mais: [Personalização de Design e Tema](/features/design) | [Recursos de Checkout](/features/checkout) | [Vitrine](/features/storefront)
### 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 |
**Valores de `dispute_status`**: `dispute_opened`, `dispute_expired`, `dispute_accepted`, `dispute_cancelled`, `dispute_challenged`, `dispute_won`, `dispute_lost`
Use estes campos para construir painéis de disputas e reembolsos, acionar alertas sobre mudanças de status de disputas ou destacar pagamentos que precisam de atenção.
Saiba mais: [API List Payments](/api-reference/payments/get-payments)
### 4. **Tabela de Reembolsos no Portal do Cliente**
O Portal do Cliente agora inclui uma seção dedicada a **Reembolsos**, onde os clientes podem ver todos os reembolsos associados aos seus pagamentos. Cada entrada de reembolso mostra o valor do reembolso, status, data e o pagamento original contra o qual foi emitido, proporcionando aos clientes total transparência no histórico de reembolsos sem precisar contatar o suporte.
A tabela de reembolsos está disponível automaticamente no portal do cliente para todos os negócios. Nenhuma configuração é necessária.
Saiba mais: [Portal do Cliente](/features/customer-portal)
### 5. **Copiar para Modo Live para Medidores**
Agora você pode **copiar medidores do modo de teste para o modo live** 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 live com todas as configurações preservadas: tipo de agregação, nome do evento, filtros e associações de crédito. Isso elimina a necessidade de recriar manualmente os medidores ao passar do desenvolvimento para a produção.
Construa e valide suas configurações de medidor no modo de teste primeiro, depois copie-as para o modo live quando estiver pronto para ir para produção. Isso garante que sua configuração de cobrança seja testada antes de lidar com o uso real do cliente.
Saiba mais: [Cobrança Baseada em Uso](/features/usage-based-billing/introduction) | [Medidores](/features/usage-based-billing/meters)