Portal do Cliente

O Customer Portal é uma área segura hospedada onde seus clientes podem gerenciar assinaturas, visualizar faturas e acessar detalhes das chaves de licença — sem entrar em contato com o suporte.

Create Portal Session (API)

Crie programaticamente sessões de portal seguras e com tempo limitado.

Subscriptions

Gerencie planos recorrentes, upgrades, downgrades e complementos.

Portal do Cliente reformulado mostrando assinaturas ativas, métodos de pagamento e histórico de cobrança

O que é o Portal do Cliente?

O portal oferece uma experiência de autoatendimento confiável e com a marca para os clientes:

Acessar o histórico de cobrança: visualize faturas e baixe recibos.
Gerenciar assinaturas: visualize os detalhes da assinatura, pause e retome assinaturas e cancele assinaturas imediatamente ou na próxima data de cobrança.
Atualizar métodos de pagamento: altere os métodos de pagamento de assinaturas ativas ou reative assinaturas suspensas.
Obter chaves de licença: acesse todas as chaves vinculadas às compras.
Navegar com facilidade: use o botão de voltar para se mover entre as seções do portal sem perder o contexto.

Principais Benefícios

Menor volume de suporte: Clientes resolvem solicitações comuns de faturamento por conta própria.
Tempo de valor mais rápido: Acesso imediato a faturas e chaves.
Redução do risco de churn: Visibilidade clara sobre renovações e detalhes do plano.
Seguro por design: Acesso tokenizado com links que expiram.

Métodos de Acesso

Os clientes podem acessar o portal usando um link estático ou um link dinâmico de uso único.

Link estático (acesso baseado em e-mail)

Os clientes podem solicitar acesso ao portal inserindo seu e-mail em um link estático que nunca expira. O formato do link estático do portal varia conforme o ambiente: Modo de Teste (para testes e desenvolvimento):

https://test.customer.dodopayments.com/login/{business_id}

Modo Ao Vivo (para produção com transações reais):

https://customer.dodopayments.com/login/{business_id}

Substitua {business_id} pelo seu identificador comercial real, depois compartilhe o link apropriado com os clientes para que eles possam inserir o e-mail e receber acesso seguro ao portal.

Merchant flow

Vá para Sales → Customer.
Clique em Share invite.
Copie o Static link e compartilhe-o com seu cliente.

Customer flow

Abra o link estático.
Digite o e-mail usado na compra.
Receba um link de login seguro para acessar o portal.

Clientes existentes são reconhecidos automaticamente.

Link dinâmico (link mágico)

Um link mágico personalizado e de uso único que envia os clientes diretamente para o portal. O link expira em 24 horas.

Links dinâmicos expiram após 24 horas. Se expirar, gere e envie um novo link.

Merchant flow

Vá para Sales → Customer.
Clique em Share invite.
Copie o Dynamic link e compartilhe-o com seu cliente.

Customer flow

Abra o link dinâmico.
Acesse o Customer Portal diretamente sem inserir um e-mail.

Recursos do Portal

O Portal do Cliente reformulado oferece uma interface limpa e unificada com uma barra lateral à esquerda e seções organizadas para todas as necessidades de gestão da conta.

Active Subscriptions

Visualize todas as assinaturas ativas com nome do plano, preço, data de renovação e validade. Clique em “Gerenciar assinatura” para visualizar os detalhes, editar as informações de cobrança, pausar ou cancelar.

Payment Methods

Veja todos os métodos de pagamento salvos (cartões, UPI etc.) com facilidade. Edite os métodos de pagamento diretamente pelos detalhes da assinatura.

Billing History

Veja todas as transações em uma tabela detalhada com data, status, tipo de precificação, direitos e faturas para download.

Billing Information

Visualize e edite seu nome, e-mail, telefone e endereço de cobrança diretamente na página de detalhes da assinatura.

Visão geral do portal

A página principal do portal exibe todas as assinaturas ativas, métodos de pagamento salvos e histórico de cobrança em uma única visualização rolável.

Página principal do Customer Portal mostrando assinaturas ativas e métodos de pagamento

Métodos de pagamento e histórico de cobrança

Role para baixo para visualizar os métodos de pagamento salvos e um histórico completo de cobrança com indicadores de status e faturas para download.

Alterações de plano (Upgrade/Downgrade)

Quando os produtos estão organizados em Product Collections, os clientes podem fazer upgrade ou downgrade entre planos diretamente pelo Customer Portal.

Deseja habilitar upgrade/downgrade para assinaturas existentes? Adicione seus produtos de assinatura a uma Product Collection. Após agrupados, os clientes podem alternar entre planos na mesma coleção pelo Customer Portal.

Detecção automática: Na primeira visita, o portal detecta o idioma preferido do cliente a partir das configurações do navegador e carrega a tradução correspondente, se disponível. O inglês é usado como padrão.
Substituição manual: Os clientes podem alterar o idioma ativo a qualquer momento através do seletor de idiomas no cabeçalho do portal (disponível tanto em desktop quanto em dispositivos móveis).
Preferência persistente: O idioma selecionado é armazenado no cookie NEXT_LOCALE (válido por 1 ano) para que o portal lembre-se da escolha em diferentes sessões.

Ação	Descrição	Quando disponível
Upgrade	Mova para um plano de nível superior dentro da mesma coleção	O negócio habilitou atualizações de assinatura
Downgrade	Mova para um plano de nível inferior dentro da mesma coleção	O negócio habilitou atualizações de assinatura

Como funcionam as alterações de plano

O cliente visualiza a assinatura atual no portal
As opções de upgrade/downgrade disponíveis são exibidas com base na coleção de produtos
O cliente seleciona o novo plano
A prorrata é calculada e o pagamento é processado imediatamente (quando aplicável)
A assinatura é atualizada para o novo plano

Alterações de plano estão disponíveis apenas entre produtos dentro da mesma coleção. Os produtos devem ser do tipo assinatura ou cobrança baseada em uso.

Controles comerciais

As empresas podem configurar o comportamento de alteração de plano em Configurações de Assinatura:

Permitir atualizações de assinatura: habilite ou desabilite a capacidade dos clientes de fazer upgrade ou downgrade das assinaturas

Product Collections

Aprenda como configurar Product Collections e definir caminhos de upgrade/downgrade.

Detalhes da assinatura

Quando os clientes clicam em “Manage subscription” em qualquer assinatura ativa, eles são levados à página de detalhes da assinatura. Essa página mostra:

Detalhes do plano: nome da assinatura, preço, data de renovação e período de validade
Método de pagamento: o cartão ou método vinculado à assinatura, com um botão “Edit”
Informações de cobrança: nome, e-mail, telefone e endereço de cobrança com um botão “Edit”
Histórico de cobrança: uma tabela detalhada de todos os pagamentos dessa assinatura
Cancelar assinatura: um botão em destaque para cancelar a assinatura

As empresas podem configurar o comportamento das assinaturas no portal em Configurações de Assinatura:

Permitir atualizações de assinatura: ative ou desative a capacidade de os clientes fazerem upgrade ou downgrade das próprias assinaturas
Permitir cancelamento de assinatura: ative ou desative a capacidade de os clientes cancelarem as próprias assinaturas
Permitir pausa de assinatura: ative ou desative a capacidade de os clientes pausarem e retomarem as próprias assinaturas

Os clientes podem cancelar a assinatura diretamente na página de detalhes da assinatura. Ao clicar em “Cancel Subscription”, é exibido um diálogo de confirmação com duas opções:

Cancelar na próxima data de cobrança: a assinatura permanece ativa até o fim do período atual de cobrança e, então, é cancelada automaticamente.
Cancelar agora: a assinatura é cancelada imediatamente.

Diálogo de cancelamento de assinatura com opções para cancelar na próxima data de cobrança ou cancelar imediatamente

Detalhes do plano: nome da assinatura, preço, data de renovação e período de validade
Método de pagamento: o cartão ou método de pagamento vinculado à assinatura, com um botão “Editar”
Informações de cobrança: nome, e-mail, número de telefone e endereço de cobrança, com um botão “Editar”
Histórico de cobrança: uma tabela detalhada de todos os pagamentos dessa assinatura
Pausar: uma opção para pausar a assinatura, exibida quando a pausa pelo cliente está permitida
Cancelar assinatura: um botão em destaque para cancelar a assinatura

Os clientes podem atualizar métodos de pagamento diretamente na página de detalhes da assinatura clicando em “Edit” ao lado do método de pagamento. Esse recurso é especialmente importante para reativar assinaturas que foram colocadas em espera devido a pagamentos falhos.

Reativando assinaturas em espera

Quando uma assinatura é colocada no estado on_hold devido a um pagamento falho, os clientes devem atualizar o método de pagamento para reativá-la. O processo de atualização automaticamente:

Cria uma cobrança pelos valores em aberto
Gera uma fatura para a cobrança
Processa o pagamento usando o novo método de pagamento
Reativa a assinatura para o estado active após o pagamento ser concluído com sucesso

O cancelamento self-service é controlado pela configuração Permitir cancelamento de assinatura em Configurações → Assinaturas, que vem ativada por padrão. Quando você a desativa, o botão Cancelar assinatura fica desabilitado com uma dica solicitando que o cliente entre em contato com você, e os dois caminhos de cancelamento do portal — cancelar agora e cancelar na próxima data de cobrança — são rejeitados. Os clientes que já têm um cancelamento agendado continuam tendo a opção de revogá-lo, podendo escolher permanecer. Os cancelamentos realizados por você nunca são afetados.

Motivos do cancelamento

Antes de confirmar o cancelamento, os clientes são questionados “Por que você está cancelando?” e solicitados a escolher um motivo em uma lista selecionada. O motivo é armazenado na assinatura e disponibilizado nos payloads de webhook e na API, permitindo analisar os fatores que impulsionam o churn e personalizar seus fluxos de recuperação.

Modal de cancelamento com o menu suspenso 'Por que você está cancelando?' exibindo motivos como Muito caro, Recursos ausentes e Outro

Valor	Rótulo exibido ao cliente
`too_expensive`	Muito caro
`missing_features`	Recursos ausentes
`switched_service`	Mudou para outro serviço
`unused`	Não está usando o suficiente
`customer_service`	Atendimento ao cliente ruim
`low_quality`	Baixa qualidade
`too_complex`	Muito complexo
`other`	Outro

O valor selecionado é gravado no campo cancellation_feedback da assinatura. Um campo opcional de texto livre cancellation_comment também pode ser capturado.

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

Ambos os campos também estão incluídos no payload do webhook subscription.cancelled, e você pode preenchê-los programaticamente em PATCH /subscriptions/{subscription_id} ao agendar ou executar um cancelamento por meio da API.

Combine cancellation_feedback com Recuperação de assinaturas para personalizar e-mails de recuperação — por exemplo, envie um código de desconto para clientes que cancelaram por too_expensive e uma pesquisa “o que está faltando?” para clientes que cancelaram por missing_features.

Pausar uma assinatura

A pausa oferece aos clientes uma opção intermediária entre manter uma assinatura e cancelá-la completamente. Uma assinatura pausada interrompe a cobrança, mas mantém o plano e o histórico, permitindo que o cliente volte a utilizá-la posteriormente em vez de começar do zero. Os clientes abrem a caixa de diálogo de pausa na página de detalhes da assinatura. A caixa de diálogo informa o plano atual, avisa que o acesso termina imediatamente e explica como as datas de cobrança são alteradas. O cliente confirma com Pausar assinatura.

O que é informado ao cliente e o que realmente acontece:

O acesso é interrompido imediatamente. Os recursos, downloads e chaves de licença incluídos na assinatura deixam de funcionar até que ela seja retomada.
A pausa não tem data de término. A assinatura permanece pausada até que o cliente a retome.
Nenhum período é perdido. A próxima data de cobrança e a data de renovação são adiadas pelo tempo de duração da pausa.

A retomada segue o mesmo fluxo. A assinatura retorna ao estado active e o acesso é restaurado.

A pausa pelo cliente é controlada pela configuração Permitir pausa de assinatura, em Configurações → Assinaturas, e fica desativada por padrão. Enquanto estiver desativada, os clientes não poderão iniciar uma nova pausa, embora um cliente que já esteja com uma assinatura pausada ainda possa retomá-la. As pausas realizadas por você no dashboard nunca são afetadas.

How Pausing Works

Comportamento completo da pausa, incluindo efeitos na cobrança, liquidação do uso e webhooks.

Atualizar métodos de pagamento

Os clientes podem atualizar seus métodos de pagamento diretamente na página de detalhes da assinatura, clicando em “Editar” ao lado do método de pagamento. Esse recurso é especialmente importante para reativar assinaturas que foram suspensas devido a pagamentos recusados.

Reativar assinaturas suspensas

Quando uma assinatura é colocada no estado on_hold devido a um pagamento recusado, os clientes precisam atualizar o método de pagamento para reativá-la. O processo de atualização automaticamente:

Cria uma cobrança pelos valores pendentes
Gera uma fatura para a cobrança
Processa o pagamento usando o novo método de pagamento
Reativa a assinatura para o estado active após a aprovação do pagamento

Assinaturas no estado on_hold não serão renovadas automaticamente. Os clientes precisam atualizar o método de pagamento para quitar os valores pendentes e reativar a assinatura.

Após atualizar com sucesso o método de pagamento de uma assinatura on_hold, os clientes verão uma página de confirmação e receberão notificações por e-mail sobre o pagamento realizado com sucesso e a reativação da assinatura.

Fluxo de atualização do método de pagamento

Access subscription details

Clique em “Gerenciar assinatura” em qualquer assinatura ativa na página inicial do portal.

Click Edit on payment method

Clique no botão “Editar” ao lado do método de pagamento para abrir a interface de atualização do método de pagamento.

Select or add payment method

Escolha um método de pagamento salvo existente ou adicione um novo inserindo os dados do cartão com segurança.

Confirm changes

Confirme a atualização. Para assinaturas on_hold, isso criará automaticamente uma cobrança pelos valores pendentes.

Complete payment (if on hold)

Se a assinatura estiver suspensa, os clientes serão redirecionados para concluir o pagamento dos valores pendentes. Após a aprovação do pagamento, a assinatura será reativada automaticamente.

Confirmation

Os clientes receberão a confirmação de que o método de pagamento foi atualizado e, se aplicável, de que a assinatura foi reativada.

Exemplos de integração

Crie uma sessão do Customer Portal com duração limitada para um cliente específico via API e redirecione o usuário para a URL da sessão.

const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

Customer Portal unificado

Além dos portais de clientes específicos de cada empresa, Dodo Payments oferece um Customer Portal unificado em customer.dodopayments.com, onde os clientes podem visualizar e gerenciar todas as suas compras e assinaturas em diferentes empresas que usam Dodo Payments.

Recursos do portal unificado

Visibilidade entre empresas: visualize todas as compras e assinaturas de qualquer merchant da Dodo Payments em um só lugar
Gerenciamento centralizado: gerencie assinaturas de diferentes empresas em um único dashboard
Histórico de cobrança unificado: acesse faturas e o histórico de pagamentos de todas as compras
Login único: faça login uma vez com seu e-mail para acessar compras de todos os merchants da Dodo Payments

O Customer Portal unificado complementa os portais específicos de cada empresa. Os clientes podem usar o portal do merchant com a marca ou o portal unificado, conforme sua preferência.

Solução de problemas

Link expirado: gere e envie um novo link dinâmico.
E-mail não reconhecido: peça ao cliente que use o e-mail associado à compra
Assinatura suspensa: se uma assinatura estiver suspensa, os clientes deverão atualizar o método de pagamento pelo portal para quitar os valores pendentes e reativar a assinatura. O processo de atualização cobrará automaticamente os valores pendentes.
Falha na atualização do método de pagamento: se o pagamento falhar durante o processo de atualização de uma assinatura on_hold, a assinatura permanecerá suspensa. Os clientes poderão tentar novamente com um método de pagamento diferente.

Design & Theme Customization

Personalize a aparência do seu Customer Portal com temas, tipografia, cores e visualização em tempo real pré-configurados na página Design.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Create Portal Session (API)

Subscriptions

O que é o Portal do Cliente?

Principais Benefícios

Métodos de Acesso

Link estático (acesso baseado em e-mail)

Link dinâmico (link mágico)

Recursos do Portal

Active Subscriptions

Payment Methods

Billing History

Billing Information

Visão geral do portal

Métodos de pagamento e histórico de cobrança

Alterações de plano (Upgrade/Downgrade)

Como funcionam as alterações de plano

Controles comerciais

Product Collections

Detalhes da assinatura

Reativando assinaturas em espera

Motivos do cancelamento

Pausar uma assinatura

How Pausing Works

Atualizar métodos de pagamento

Reativar assinaturas suspensas

Fluxo de atualização do método de pagamento

Exemplos de integração

Customer Portal unificado

Recursos do portal unificado

Solução de problemas

Design & Theme Customization

Create Portal Session (API)

Subscriptions

​O que é o Portal do Cliente?

​Principais Benefícios

​Métodos de Acesso

​Link estático (acesso baseado em e-mail)

​Link dinâmico (link mágico)

​Recursos do Portal

Active Subscriptions

Payment Methods

Billing History

Billing Information

​Visão geral do portal

​Métodos de pagamento e histórico de cobrança

​Alterações de plano (Upgrade/Downgrade)

​Como funcionam as alterações de plano

​Controles comerciais

Product Collections

​Detalhes da assinatura

​Reativando assinaturas em espera

​Motivos do cancelamento

​Pausar uma assinatura

How Pausing Works

​Atualizar métodos de pagamento

​Reativar assinaturas suspensas

​Fluxo de atualização do método de pagamento

​Exemplos de integração

​Customer Portal unificado

​Recursos do portal unificado

​Solução de problemas

Design & Theme Customization

O que é o Portal do Cliente?

Principais Benefícios

Métodos de Acesso

Link estático (acesso baseado em e-mail)

Link dinâmico (link mágico)

Recursos do Portal

Visão geral do portal

Métodos de pagamento e histórico de cobrança

Alterações de plano (Upgrade/Downgrade)

Como funcionam as alterações de plano

Controles comerciais

Detalhes da assinatura

Reativando assinaturas em espera

Motivos do cancelamento

Pausar uma assinatura

Atualizar métodos de pagamento

Reativar assinaturas suspensas

Fluxo de atualização do método de pagamento

Exemplos de integração

Customer Portal unificado

Recursos do portal unificado

Solução de problemas