Portal do Cliente

​

O que é o Portal do Cliente?

• 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

​

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

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

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

​

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)

• 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.

​

Como funcionam as alterações de plano

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

​

Controles comerciais

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

1. O cliente clica em Change Plan na página de detalhes da assinatura.
2. As opções de upgrade/downgrade disponíveis são exibidas com base na coleção de produtos.
3. O cliente seleciona o novo plano. Um painel Confirm Plan Change mostra o plano atual e o plano atualizado, um detalhamento por item (crédito do plano antigo, cobrança do novo plano), impostos e o valor devido agora. Os clientes também podem adicionar um código de desconto aqui.
4. O cliente confirma com Pay ${amount}.
5. O rateio proporcional é calculado e a cobrança é processada — usando o método de pagamento salvo ou uma página de checkout hospedada, caso a empresa colete pagamentos por alteração de plano por meio de um link de pagamento (veja abaixo).
6. A assinatura é atualizada para o novo plano. Se isso acontecerá imediatamente ou apenas após a compensação da cobrança depende do seu tratamento de falhas de pagamento; uma alteração de plano paga por link de pagamento sempre aguarda o pagamento.

​

Coleta de pagamentos por alteração de plano usando link de pagamento

​

Controles da empresa

• Allow Subscription Updates: Ative ou desative a possibilidade de os clientes fazerem upgrade ou downgrade de suas assinaturas
• Allow Subscription Cancellation: Ative ou desative a possibilidade de os clientes cancelarem suas próprias assinaturas
• Allow Subscription Pause: Ative ou desative a possibilidade de os clientes pausarem e retomarem suas próprias assinaturas
• Collect Plan Change Payments by Payment Link: Envie os clientes a uma página de checkout para pagar por uma alteração imediata de plano, em vez de cobrar o método de pagamento salvo. Desativado por padrão.

​

Detalhes da assinatura

• 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 “Edit”
• Informações de cobrança: Nome, e-mail, número de 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
• Pausa: Uma opção para pausar a assinatura, exibida quando você permite a pausa self-service
• Cancel Subscription: Um botão em destaque para cancelar a assinatura

​

Cancelamento de uma assinatura

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

​

Motivos do cancelamento

// 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"

​

Pausa de uma assinatura

• O acesso é interrompido imediatamente. 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 tempo é perdido. A próxima data de cobrança e a data de renovação avançam pelo mesmo período da pausa.

​

Atualização dos métodos de pagamento

​

Reativação de assinaturas em espera

1. Cria uma cobrança referente aos valores pendentes
2. Gera uma invoice para a cobrança
3. Processa o pagamento usando o novo método de pagamento
4. Reativa a assinatura para o estado active após o pagamento ser concluído com sucesso

​

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

​

Exemplos de integração

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

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

​

Unified Customer Portal

​

Recursos do Unified Portal

• Visibilidade entre empresas: Visualize em um só lugar todas as compras e assinaturas de qualquer comerciante do Dodo Payments
• Gerenciamento centralizado: Gerencie assinaturas de diferentes empresas em um único dashboard
• Histórico de cobrança unificado: Acesse invoices e o histórico de pagamentos de todas as compras
• Single sign-on: Faça login uma vez com seu e-mail para acessar compras de todos os comerciantes do Dodo Payments

​

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 em espera: Se uma assinatura estiver em espera, 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á em espera. Os clientes podem tentar novamente com um método de pagamento diferente.