O portal de clientes do Billing é um produto hospedado pela Stripe que permite aos clientes atualizar formas de pagamento, gerenciar faturas e assinaturas e visualizar o histórico de pagamentos. Esse recurso está disponível apenas para usuários pagantes do Billing.

---

Como acessar o portal de clientes do Billing

Muitas empresas começaram a usar o Stripe Billing antes de ele se tornar um produto pago. Hoje, as tarifas custam a partir de 0,7% sobre o volume do Billing e 0,4% para faturas avulsas.

Alguns novos recursos, como o portal do cliente, estão disponíveis somente para usuários pagantes do Billing. Se você não tiver acesso a esse recurso e quiser se tornar usuário pagante do Stripe Billing, fale conosco. Você pode experimentar o portal do cliente no modo de teste antes de começar a pagar.

Como configurar o portal do cliente do Billing

Para saber como configurar o portal do cliente depois de obter acesso, confira o guia de integração aqui. Para saber mais sobre como usar o portal de clientes para faturamento, verifique este guia aqui.

Perguntas frequentes

Um cliente pode criar uma assinatura pelo portal?

Não. Os clientes só podem atualizar ou cancelar uma assinatura existente, não criar outra. É possível criar assinaturas via API ou com o Checkout antes de redirecionar o cliente para o portal.

Eu defini nas configurações que posso atualizar planos. Por que só consigo cancelá-los no portal do cliente?

Detectamos que esse plano não é compatível com atualização pelo portal (consulte as limitações). Portanto, só podemos aceitar o cancelamento dessa assinatura.

Posso permitir que meus usuários cancelem as assinaturas, mas sem atualizá-las?

Sim. Para fazer isso, alterne a opção de permissão para os usuários cancelarem assinatura aqui.

Defina de forma que eles não possam fazer alterações nas assinaturas (se você quiser que eles só possam cancelá-la). Importante: você ainda precisará adicionar um URL de retorno e os links para os Termos de Serviço e Política de Privacidade.

Há uma opção no-code para o portal do cliente?

Sim, você pode ativar um link de no-code para o portal do cliente seguindo as instruções descritas aqui. Esse link pode ser incorporado ao seu site ou enviado de modo avulso aos clientes para que eles atualizem as próprias formas de pagamento e gerenciem as assinaturas.

Quais formas de pagamento são aceitas pelo portal do cliente?

Veja uma lista completa das formas de pagamento aceitas e das restrições específicas de cada país na documentação.

E se o cliente tentar excluir uma forma de pagamento durante uma assinatura ativa?

Quando o cliente tem uma assinatura ativa, o portal exige que ele mantenha pelo menos uma forma de pagamento para a cobrança da assinatura. Se ele quiser alterar a forma de pagamento, precisará adicionar outra antes de excluir a atual.

Posso criar configurações diferentes do portal do cliente para grupos distintos de clientes?

Isso só é possível usando a API para passar o ID da configuração específica que você deseja mostrar ao cliente quando cria a sessão do portal. Quando você usa o Dashboard, só pode definir uma configuração padrão.

Posso adicionar texto personalizado ao portal do cliente?

Não é possível adicionar texto personalizado ao portal do cliente, mas você pode configurar o uso da marca pelo portal nas configurações de marca.

O portal do cliente aceita domínios personalizados?

Sim. Para saber mais sobre como as superfícies hospedadas pela Stripe funcionam com domínios personalizados, leia a documentação aqui.

Recebi uma mensagem de erro ao tentar adicionar um produto ao portal. O que aconteceu?

Se você receber a mensagem de erro acima ao tentar adicionar um produto ao portal, é porque está tentando adicionar o mesmo produto com o mesmo intervalo e moeda do que já foi adicionado.

Você pode ter o mesmo intervalo e moeda se o produto for diferente, mas, se o produto for igual, só poderá ter mais um parâmetro igual (intervalo ou moeda).

Leia mais sobre isso em nosso guia de práticas recomendadas para a criação de produtos aqui.

O portal do cliente permite "suspender" assinaturas?

Não. O portal do cliente não permite que um cliente suspenda uma assinatura.

A Stripe permite suspender assinaturas no Dashboard ou usando a API?

Não. A cobrança de pagamentos de uma assinatura pode ser suspensa usando o Dashboard ou a API, mas o status da assinatura não muda para "Suspensa".

O que muda em 29 de março de 2024?

O botão "Suspender plano" não será mais mostrado aos clientes no portal do cliente.

Se você já tinha ativado o recurso "Suspender assinatura" nas configurações do portal do cliente, essas configurações continuarão oferecendo a opção de ativar/desativar a retomada da cobrança de pagamentos para assinaturas com a cobrança de pagamentos suspensa no portal do cliente até 1º de agosto de 2024.

Como faço para determinar quais assinaturas estão com a cobrança de pagamentos suspensa?

As assinaturas com a cobrança de pagamentos suspensa podem ser encontradas no Dashboard: use o botão "Filtrar" no canto superior direito, selecione "Cobrança suspensa" em "Status de cobrança" e clique no botão "Concluído".

Para exportar um arquivo CSV dessas assinaturas, clique no botão "Exportar". Essas assinaturas também podem ser encontradas na API, basta examinar as que têm pause_collection.behavior com valor não nulo.

A API de configuração do portal do cliente está mudando?

Se você já usou o recurso de suspender assinatura no portal do cliente, pode passar `features.subscription_pause` quando criar uma configuração do portal do cliente.

No entanto, a suspensão só será acionada se o cliente puder retomar a cobrança de pagamentos de uma assinatura no portal do cliente. O parâmetro não habilita os clientes a suspender a cobrança de pagamentos no portal do cliente.

Além disso, ele será totalmente removido da API até 1º de agosto de 2024. A partir da remoção, a passagem do parâmetro features.subscription_pause retornará um erro.

Todas as integrações que usam esse parâmetro devem ser atualizadas antes de 1º de agosto de 2024 para evitar erros.

Quando os clientes não poderão mais retomar a cobrança de pagamentos no portal do cliente?

Para os usuários que já ativaram o recurso "Suspender assinatura" no portal do cliente, seus clientes não poderão mais retomar cobranças suspensas de pagamento da assinatura no portal a partir de 1º de agosto de 2024.

E se eu precisar de uma solução para permitir que os clientes suspendam assinaturas antes que a Stripe ofereça esse recurso?

Hoje, a única opção é desativar a cobrança de pagamentos no Dashboard ou diretamente pela API e provisionar seus serviços com base no campo pause_collection, quando o webhook de atualização da assinatura do cliente for enviado. O status da assinatura permanecerá ativo. Portanto, você precisará verificar manualmente se os serviços devem ser mantidos ou suspensos para esses clientes.