> ## 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.113.28 (10 de setembro de 2026)

> Uma nova aba de Reports com exportações de saldo, taxas e reconciliação, períodos de carência para assinaturas, uma lista de bloqueio de clientes, nova tentativa manual de pagamento, um registro de atividades em cada pagamento, um formulário de descontos reformulado, controles separados de cancelamento, assinaturas sem exigência de cartão quando nada é devido hoje, uma opção obrigatória de Tax ID no checkout B2B e checkout em georgiano.

## Novos recursos

### 1. **Reports**

Uma nova aba de **Reports** em **Settings** reúne relatórios de saldo, taxas e reconciliação em um só lugar.

**Acompanhe a movimentação de dinheiro**

Duas visualizações sempre atualizadas, descritas como "Entenda como a atividade, as taxas e os payouts afetam seu saldo":

* **Resumo de saldo e payouts** — saldo inicial, detalhamento da atividade e detalhes de cada payout em uma única visualização
* **Todas as taxas** — um detalhamento completo de cada taxa cobrada no período

**Baixe relatórios**

Crie uma exportação personalizada em CSV ou XLSX para qualquer intervalo de datas, a partir de quatro tipos de relatório: o **Relatório de transações**, o **Relatório de ajustes**, o **Relatório de payouts** e o **Relatório de reconciliação do ledger**. O Relatório de reconciliação do ledger grava uma linha para cada movimentação de saldo, desenvolvido para ser conciliado com seu extrato bancário.

**Relatórios gerados**

Tudo o que você exportou aparece em **Relatórios gerados**, com o intervalo de datas, o formato, a quantidade de linhas, quem o gerou e uma ação de download.

<Frame>
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/reports-hub.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=5ca9b31a0a29106dba531c8e1c5a7f9d" alt="Aba Reports mostrando as seções Acompanhe a movimentação de dinheiro, Baixe relatórios e Relatórios gerados" style={{ maxHeight: '500px', width: 'auto' }} width="1400" height="700" data-path="images/reports/reports-hub.png" />
</Frame>

Saiba mais: [Reports](/features/reports)

### 2. **Período de carência da assinatura**

Uma assinatura cuja renovação falha agora pode continuar funcionando durante um período configurável, em vez de ficar imediatamente em espera.

Ative **Período de carência da assinatura** em **Settings → Subscriptions** e defina o **Número de dias do período de carência** — qualquer valor entre 1 e 30 dias. Os períodos de carência ficam desativados por padrão.

Durante esse período, a assinatura assume o novo status `past_due`: o acesso é preservado e o uso continua sendo acumulado, para que um cliente cujo cartão simplesmente expirou não seja interrompido enquanto resolve o problema. Um novo webhook `subscription.past_due` é disparado quando o período começa.

Escolha o que acontece se o período terminar sem pagamento em **Status da assinatura após o período de carência** — **Em espera**, que corresponde ao comportamento atual, ou **Cancelar assinatura**.

<Frame>
  <img src="https://mintcdn.com/dodopayments/S2k6LKmgHYlRKci9/images/subscriptions/subscription-grace-period-settings.png?fit=max&auto=format&n=S2k6LKmgHYlRKci9&q=85&s=4c506116408f7c800bdd13d7561db86c" alt="Configuração do período de carência da assinatura com o número de dias e o status a aplicar após o período de carência" style={{ maxHeight: '500px', width: 'auto' }} width="1373" height="184" data-path="images/subscriptions/subscription-grace-period-settings.png" />
</Frame>

Saiba mais: [Período de carência](/features/subscription#grace-period)

### 3. **Lista de bloqueio de clientes**

Bloqueie um cliente que não deve poder comprar novamente de você, usando o ID do cliente ou o endereço de e-mail.

O bloqueio cancela as assinaturas ativas do cliente, interrompe futuras sessões de checkout e pagamentos diretos e deixa o Customer Portal somente para leitura. Como as entradas correspondem ao endereço de e-mail, um cliente que se cadastrar novamente com o mesmo e-mail continuará sendo bloqueado.

As entradas da lista de bloqueio incluem notas, para que você possa registrar o motivo do bloqueio.

<Frame>
  <img src="https://mintcdn.com/dodopayments/c1t35qHSH45TR4GO/images/blocklist/blocklist-settings.png?fit=max&auto=format&n=c1t35qHSH45TR4GO&q=85&s=771eb4a5654fbd22e6a5110cfb1a2e9d" alt="Configurações da lista de bloqueio exibindo clientes bloqueados" style={{ maxHeight: '500px', width: 'auto' }} width="2358" height="1554" data-path="images/blocklist/blocklist-settings.png" />
</Frame>

Saiba mais: [Lista de bloqueio de clientes](/features/customer-blocklist)

### 4. **Nova tentativa manual de pagamento**

Tente novamente uma renovação de assinatura com falha em vez de esperar pela agenda automática de novas tentativas, usando **Tentar pagamento manualmente** na página de detalhes do pagamento. A cobrança é feita no método de pagamento já salvo na assinatura, portanto o cliente não precisa fazer nada, e isso não consome uma tentativa da agenda automática.

Cada fatura de renovação permite até três novas tentativas manuais, com um período de espera entre elas — uma hora antes da segunda e três horas antes da terceira — para que recusas repetidas não prejudiquem sua taxa de autorização.

<Frame>
  <img src="https://mintcdn.com/dodopayments/0duTS18kYi2NwQ3m/images/recovery/manual-retry-transaction-details.png?fit=max&auto=format&n=0duTS18kYi2NwQ3m&q=85&s=5537fa5eff17cbe91a53599f887a26e7" alt="Página de detalhes do pagamento com a ação Tentar pagamento manualmente" style={{ maxHeight: '500px', width: 'auto' }} width="1285" height="698" data-path="images/recovery/manual-retry-transaction-details.png" />
</Frame>

Saiba mais: [Nova tentativa manual de pagamento](/features/recovery/manual-retry)

### 5. **Registro de atividades nos pagamentos**

Agora, toda página de detalhes do pagamento inclui um **Registro de atividades** — "Um histórico das ações realizadas nesta transação nos últimos 90 dias".

O registro acompanha todo o ciclo de vida em ordem, desde **Pagamento iniciado**, passando pela autenticação e captura, até **Pagamento concluído**, e continua com reembolsos e disputas, para que um pagamento contestado seja apresentado como uma única história, em vez de vários registros desconectados.

<Frame>
  <img src="https://mintcdn.com/dodopayments/YYTuTm3Tnxw8EJWt/images/transactions/payments/activity-log.png?fit=max&auto=format&n=YYTuTm3Tnxw8EJWt&q=85&s=3f60d02d04cf0cef958f0ec18406e9a8" alt="Registro de atividades em uma página de detalhes do pagamento mostrando uma entrada de Pagamento concluído com seu timestamp" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="962" data-path="images/transactions/payments/activity-log.png" />
</Frame>

### 6. **Um formulário de descontos reformulado**

Agora, ao criar um código de desconto, você vê o que está criando enquanto o cria. Um painel lateral alterna entre **Resumo**, uma descrição em linguagem simples do desconto, e **Prévia**, que exibe o desconto como o cliente o veria no checkout.

**Opções de moeda** permite definir o valor do desconto para cada moeda em que você vende. **Elegibilidade e restrições** reúne as regras de produto e de cliente.

Os limites de resgate, o limite de ciclos de cobrança e **Exigir um valor mínimo do pedido** — um valor mínimo do carrinho aplicado por moeda — agora ficam em **Avançado**.

<Frame>
  <img src="https://mintcdn.com/dodopayments/28D42lhMYyiRjtpN/images/discount-codes/discount-form-summary.png?fit=max&auto=format&n=28D42lhMYyiRjtpN&q=85&s=1f2c1d04fbbbac53f67d789d81e0a382" alt="Formulário de código de desconto com os painéis laterais Resumo e Prévia ao lado dos detalhes do desconto" style={{ maxHeight: '500px', width: 'auto' }} width="1920" height="963" data-path="images/discount-codes/discount-form-summary.png" />
</Frame>

Saiba mais: [Códigos de desconto](/features/discount-codes)

### 7. **Controles de cancelamento separados**

O cancelamento pelo próprio cliente costumava ser uma única opção. Agora, são duas configurações independentes em **Settings → Subscriptions**:

* **Permitir cancelamento imediato** — "Permitir que os clientes encerrem a assinatura e percam o acesso imediatamente."
* **Permitir cancelamento na próxima data de cobrança** — "Permitir que os clientes cancelem no fim do período pelo qual já pagaram."

Assim, você pode permitir que os clientes utilizem todo o período pelo qual pagaram, mantendo o cancelamento imediato somente para você, ou fazer o contrário.

No Customer Portal, as duas opções aparecem como ações separadas: **Cancelar agora** e **Cancelar na próxima data de cobrança**. Quando um cancelamento já está agendado, o portal oferece a opção de revogá-lo, junto com **Cancelar imediatamente** — a mesma ação que **Cancelar agora**, renomeada para esse estado.

<Frame>
  <img src="https://mintcdn.com/dodopayments/kCngKZVrb0rZMS1f/images/customer-portal/cance-sub.png?fit=max&auto=format&n=kCngKZVrb0rZMS1f&q=85&s=66eb6e380c991826c431fd0c563cbfa6" alt="Diálogo de cancelamento do Customer Portal oferecendo o cancelamento agora ou na próxima data de cobrança" style={{ maxHeight: '500px', width: 'auto' }} width="2880" height="1550" data-path="images/customer-portal/cance-sub.png" />
</Frame>

Saiba mais: [Cancelamento de uma assinatura](/features/customer-portal#cancelling-a-subscription)

### 8. **Alterações de plano pagas em uma página de checkout**

Ative **Cobrar pagamentos de alterações de plano por Payment Link** em **Settings → Subscriptions** para que um cliente que faça upgrade no Customer Portal pague pela alteração em uma página de checkout hospedada, em vez de usar o mandato armazenado.

O botão de confirmação mostra o valor devido e, quando o checkout é aberto, o cliente recebe a mensagem: "Conclua seu pagamento na nova aba. Seu plano atual permanece ativo até que o pagamento seja concluído." A assinatura permanece no plano antigo até que o pagamento seja concluído, e um pagamento recusado pode ser tentado novamente no mesmo link.

O Customer Portal também identifica agora se você permite o cancelamento de uma alteração de plano agendada, exibindo ou ocultando esse controle em vez de oferecer uma ação que seria recusada.

<Frame>
  <img src="https://mintcdn.com/dodopayments/LwHMYe4qXgVFVIvC/images/customer-portal/plan-change-checkout.png?fit=max&auto=format&n=LwHMYe4qXgVFVIvC&q=85&s=91bbe7cab1c13809fa9dc240d851015e" alt="Página de checkout hospedada para o pagamento de uma alteração de plano" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1167" data-path="images/customer-portal/plan-change-checkout.png" />
</Frame>

Saiba mais: [Alterações de plano](/features/customer-portal#plan-changes-upgradedowngrade)

### 9. **Limite de novas tentativas de KYC**

Agora, uma verificação de identidade com falha informa por que falhou e quantas tentativas ainda estão disponíveis, em vez de simplesmente informar uma falha.

Cada usuário recebe três tentativas, e o aviso exibe "Tentativas restantes: 2/3" com o motivo real informado pelo provedor de verificação. O botão muda para **Tentar novamente** enquanto ainda houver tentativas. Quando as três forem usadas, o aviso explica que o suporte pode reabrir a verificação.

Saiba mais: [Verificação da conta](/miscellaneous/verification-process)

### 10. **Checkout em georgiano**

O checkout agora está disponível em georgiano, elevando o total para 22 idiomas. O georgiano é detectado pelo navegador do cliente como qualquer outro idioma compatível, ou você pode defini-lo com o parâmetro `force_language`.

Saiba mais: [Idiomas compatíveis](/features/checkout#supported-languages)

### 11. **Sem exigência de cartão para preço de \$0**

Agora, uma assinatura pode começar sem um método de pagamento sempre que nada for devido hoje. Ative a caixa de seleção **Sem exigência de cartão para preço de \$0** na seção de preços do produto, ao lado de **Período de teste (dias)** e **Desconto padrão (%)**.

Há duas formas de não haver nada devido hoje, e a mesma caixa de seleção abrange ambas:

* **Um período de teste gratuito** — um período de teste sem valor de teste, portanto a primeira cobrança é `0` enquanto o teste estiver em andamento.
* **Um preço recorrente de \$0** — o preço pode ser `0` desde o início, ou um desconto pode reduzi-lo a esse valor, seja pelo **Desconto padrão (%)** do próprio produto ou por códigos de desconto acumulados que totalizem 100% de desconto no checkout.

Um teste pago ainda exige um cartão, pois um valor de teste significa que há algo devido.

Sem um cartão registrado, a assinatura é ativada mesmo assim e retorna `payment_method_required: false`. Em seguida, um e-mail de lembrete é enviado antes do início da cobrança real — com a antecedência definida por **Lembrete de método de pagamento** em **Settings → Subscriptions**, entre 1 e 30 dias, com o padrão de 3 dias. Se o cartão nunca for adicionado, a assinatura passa para `on_hold` quando a primeira cobrança real vencer, e adicionar um método de pagamento a reativa. Dois e-mails para clientes abrangem esse processo, ambos ativados por padrão: **Lembrete para adicionar método de pagamento** e **Assinatura em espera, sem método de pagamento**.

Na API, a única caixa de seleção corresponde a dois campos de preço independentes, `trial_payment_method_optional` e `zero_amount_payment_method_optional`, para que você possa ativar cada caso separadamente se gerenciar os produtos diretamente.

<Frame>
  <img src="https://mintcdn.com/dodopayments/qD0RSXoLZULfSVwD/images/subscriptions/card-optional-at-zero-price-pricing.png?fit=max&auto=format&n=qD0RSXoLZULfSVwD&q=85&s=d76357fda744c461e140675834f25e7b" alt="Formulário de preços da assinatura com a caixa Sem exigência de cartão para preço de $0 ao lado de Período de teste e Desconto padrão" style={{ maxHeight: '500px', width: 'auto' }} width="1814" height="1240" data-path="images/subscriptions/card-optional-at-zero-price-pricing.png" />
</Frame>

Saiba mais: [Sem exigência de cartão para preço de \$0](/features/subscription#card-optional-at-0-price)

### 12. **Tax ID obrigatório no checkout**

As sessões de checkout aceitam agora uma nova flag de recurso `require_tax_id`, para empresas que vendem somente para empresas registradas. O padrão é `false`, portanto nada muda a menos que você solicite esse comportamento.

Com a flag ativada, **Comprar como empresa** fica pré-selecionado e bloqueado na página de checkout, **Nome da empresa** e **Número do Tax ID** tornam-se obrigatórios, e **Continuar para o pagamento** permanece desativado enquanto qualquer um deles estiver vazio ou o Tax ID for rejeitado. A validação do Tax ID continua sendo fail-open, portanto uma indisponibilidade na consulta nunca bloqueia o cliente diretamente.

`allow_tax_id` também deve ser `true` ou a solicitação será rejeitada com um `400`, e uma sessão criada com `confirm: true` precisa conter um `tax_id` porque ignora completamente a página de checkout.

A exigência é aplicada na página de checkout, e não no servidor — uma confirmação enviada diretamente à API ainda pode omitir `tax_id`. Portanto, trate a flag como um controle da experiência de checkout, e não como uma garantia.

Saiba mais: [Tornando o Tax ID obrigatório](/features/b2b-payments#making-the-tax-id-mandatory)

### 13. **Notificações de assinatura pausada e retomada**

Pausar e retomar uma assinatura agora gera notificações próprias, para sua equipe e para o cliente.

As notificações para a equipe adicionam **Assinatura pausada** e **Assinatura retomada** em **Subscriptions**, ambas desativadas por padrão — são os primeiros eventos de assinatura aqui que não são enviados ativados; portanto, ative-os se quiser recebê-los. Os e-mails correspondentes para clientes ficam ativados por padrão, como todos os outros e-mails para clientes.

Saiba mais: [Preferências de comunicação](/features/communication-preferences#subscriptions)
