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:

Acesse o histórico de cobrança: visualize faturas e faça o download de recibos.
Gerencie assinaturas: visualize detalhes da assinatura, cancele-a imediatamente ou na próxima data de cobrança.
Atualize métodos de pagamento: altere os métodos de pagamento para assinaturas ativas ou reative assinaturas em espera.
Recupere chaves de licença: acesse todas as chaves vinculadas às compras.

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

Veja todas as assinaturas ativas com nome do plano, preço, data de renovação e validade. Clique em “Manage subscription” para visualizar detalhes, editar informações de cobrança 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.

Ações disponíveis

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

Cancelamento de uma assinatura

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

Atualizando métodos de pagamento

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

Assinaturas no estado on_hold não renovarão automaticamente. Os clientes devem atualizar o método de pagamento para quitar os valores em aberto e reativar a assinatura.

Após atualizar o método de pagamento com sucesso para 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 e a reativação bem-sucedida.

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

Access subscription details

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

Click Edit on payment method

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

Select or add payment method

Escolha um método de pagamento salvo existente ou adicione um novo inserindo os dados do cartão de forma segura.

Confirm changes

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

Complete payment (if on hold)

Se a assinatura estiver em espera, os clientes serão redirecionados para concluir o pagamento dos valores em aberto. Após o pagamento bem-sucedido, a assinatura é reativada automaticamente.

Confirmation

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

Exemplos de integração

Crie uma sessão do Customer Portal com tempo limitado para um cliente específico via API e, em seguida, 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;