Portal do Cliente

​

O que é o Customer Portal?

• Acessar o histórico de faturamento: visualizar pagamentos anteriores e baixar faturas.
• Gerenciar assinaturas: visualizar detalhes da assinatura, pausá-la e retomá-la, além de cancelá-la imediatamente ou na próxima data de faturamento, conforme permitido pelas suas configurações.
• Atualizar métodos de pagamento: alterar o método de pagamento de uma assinatura ou reativar uma assinatura que está suspensa.
• Recuperar chaves de licença: ver as chaves de licença associadas às compras.
• Voltar ao seu app: quando você fornece um return_url, o portal mostra um link de retorno para sua empresa. No celular, uma seta de retorno no cabeçalho leva de volta à visão geral do portal.

​

Principais benefícios

• Menor volume de suporte: os clientes resolvem sozinhos solicitações comuns de faturamento.
• Acesso mais rápido: os clientes obtêm faturas e chaves de licença assim que entram.
• Menor risco de churn: os clientes veem as datas de renovação e os detalhes do plano antes de serem cobrados.
• Links assinados com expiração: cada link de acesso é assinado e expira após 24 horas.
• Experiência localizada: o portal está disponível em 21 idiomas e escolhe um deles com base nas configurações do navegador do cliente.

​

Métodos de acesso

​

Link estático (acesso por e-mail)

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

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

​

Link dinâmico (Magic Link)

​

Recursos do portal

​

Visão geral do portal

​

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

​

Suporte a idiomas

​

Como funciona a seleção de idioma

• Detecção automática: na primeira visita, o portal lê o idioma preferido do navegador e o carrega se houver suporte. Caso contrário, usa inglês.
• Substituição manual: os clientes podem alterar o idioma a qualquer momento usando o seletor de idioma no canto inferior direito da página, no desktop e no celular.
• Preferência persistente: o portal armazena a escolha no cookie NEXT_LOCALE por um ano, lembrando o idioma entre as visitas.

​

Idiomas compatíveis

​

Alterações de plano (upgrade/downgrade)

​

Ações disponíveis

​

Como funcionam as alterações de plano

1. O cliente clica em Change Plan na página de detalhes da assinatura.
2. O portal lista os outros planos da coleção de produtos.
3. O cliente seleciona um plano. Um painel Confirm Plan Change mostra o plano atual e o atualizado, o detalhamento dos itens (um crédito pelo plano antigo e uma cobrança pelo novo), o imposto e o valor devido agora. O cliente também pode inserir um código de desconto nesse momento.
4. O cliente confirma com o botão Pay, que mostra o valor devido.
5. O Dodo Payments calcula o rateio proporcional e realiza a cobrança, usando o método de pagamento salvo ou uma página de checkout hospedada se você cobrar alterações de plano por payment link (consulte Cobrando pagamentos de alteração de plano por Payment Link).
6. A assinatura muda para o novo plano. Se isso ocorre imediatamente ou somente após a cobrança ser concluída depende do seu tratamento de falhas de pagamento. Uma alteração de plano paga por payment link sempre aguarda o pagamento.

​

Coleta de pagamentos de alterações de plano por Payment Link

​

Controles da empresa

• Allow Subscription Updates: permite que os clientes façam upgrade ou downgrade. Desativado por padrão.
• Allow Immediate Cancellation: permite que os clientes encerrem a assinatura e percam o acesso imediatamente. Ativado por padrão.
• Allow Cancellation at Next Billing Date: permite que os clientes cancelem ao final do período pelo qual pagaram. Ativado por padrão.
• Allow Subscription Pause: permite que os clientes pausem e retomem suas próprias assinaturas. Desativado por padrão.
• Collect Plan Change Payments by Payment Link: direciona 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: o nome da assinatura, o preço, a data de renovação e o período de validade.
• Método de pagamento: o método de pagamento da assinatura, com um botão Edit.
• Informações de faturamento: nome, e-mail, número de telefone e endereço de faturamento, com um botão Edit para o nome e o endereço de faturamento.
• Histórico de faturamento: uma tabela com todos os pagamentos dessa assinatura.
• Pause Subscription: exibido quando você permite a pausa self-service.
• Cancel Subscription: abre a caixa de diálogo de cancelamento.

​

Cancelamento de uma assinatura

• Cancel at next billing date: a assinatura permanece ativa até o fim do período de faturamento atual e então é cancelada.
• Cancel now: a assinatura é cancelada imediatamente.

​

Motivos do cancelamento

// `client` is a DodoPayments client, created as in the Integration Guide.
// 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"

​

Pausar 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 período pago é perdido. A próxima data de faturamento e a data de renovação avançam pelo mesmo período da pausa.

​

Atualização de métodos de pagamento

​

Reativação de assinaturas em espera

1. Cria uma cobrança referente aos valores restantes
2. Gera uma fatura para a cobrança
3. Coleta o pagamento com o novo método de pagamento
4. Reativa a assinatura para active quando o pagamento é concluído

​

Reativação de assinaturas em período de carência

​

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

​

Exemplos de integração

// Server: `client` is a DodoPayments client, created as in the Integration Guide.
const session = await client.customers.customerPortal.create('cus_123', {
  return_url: 'https://yourapp.com/account', // optional: shown as a back link in the portal
});

// Send session.link to the browser, then redirect the customer:
// window.location.href = session.link;

​

Unified Customer Portal

​

Recursos do Unified Portal

• Visibilidade entre empresas: veja compras e assinaturas de todos os merchants do Dodo Payments em um só lugar.
• Gerenciamento centralizado: gerencie assinaturas com diferentes empresas em um único site.
• Histórico de faturamento unificado: acesse faturas e o histórico de pagamentos de todas as compras.
• Acesso único: entre uma vez com um endereço de e-mail para acessar compras de todos os merchants do Dodo Payments.

​

Solução de problemas

• Link expirado: gere um novo link dinâmico e envie-o ao cliente.
• E-mail não reconhecido: peça ao cliente que use o endereço de e-mail da compra. Nenhum e-mail de acesso é enviado para um endereço que não pertença a um cliente da sua empresa.
• Assinatura suspensa: o cliente atualiza o método de pagamento no portal. O Dodo Payments cobra os valores restantes e reativa a assinatura quando o pagamento é concluído.
• Falha na atualização do método de pagamento: se o pagamento falhar durante a atualização de uma assinatura on_hold, ela permanecerá suspensa. O cliente poderá tentar novamente com outro método de pagamento.