O portal do cliente 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 do cliente 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,5% para cobranças recorrentes e 0,4% para faturas avulsas após as primeiras 25 faturas gratuitas mensalmente.

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 do cliente 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 pela API ou com o Checkout antes de redirecionar o cliente para o portal.

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). Com isso, só temos como 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á alguma opção sem código para o portal do cliente?

Sim, você pode ativar um link sem código no portal do cliente seguindo as etapas descritas aqui. Este link pode ser útil para integração ao seu site ou para enviar aos clientes de forma avulsa e permitir que atualizem as informações da forma de pagamento e gerenciem a assinatura.

Quais formas de pagamento o portal do cliente aceita?

Há uma lista completa das formas de pagamento aceitas e das restrições específicas dos países em nossa documentação.

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

Se o cliente tiver uma assinatura ativa, o portal exigirá a manutenção de pelo menos uma forma de pagamento para cobrar a assinatura. Caso ele queira alterar a forma de pagamento, será necessário adicionar outra antes de excluir a existente.

Posso criar configurações diferentes do portal do cliente para cada conjunto de clientes?

Só é possível fazer isso pela API, em que você pode passar o ID da configuração específica que gostaria de mostrar ao cliente quando criar a sessão do portal. Se você usa o Dashboard, só é possível 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 adaptar a marca do portal nas configurações de marca.

O portal do cliente aceita domínios personalizados?

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

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

Se você recebeu 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 aqui, em nosso guia de práticas recomendadas para criação de produtos.

O portal do cliente aceita assinaturas "suspensas"?

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

A Stripe permite suspender assinaturas no Dashboard ou na API?

Não. A cobrança de pagamento de uma assinatura pode ser suspensa pelo Dashboard ou pela API, mas o status dela não mudará para "suspenso".

O que vai mudar em 29 de março de 2024?

Seus clientes não verão mais o botão "Suspender plano" no portal do cliente. 

Se você ativou o recurso "Suspender assinatura" nas configurações do portal do cliente, ainda haverá a opção de ativar/desativar a retomada da cobrança de pagamento de assinaturas com cobrança suspensa no portal do cliente até 1º de agosto de 2024.

Como faço para saber quais assinaturas tiveram a cobrança de pagamento suspensa?

Para consultar as assinaturas cuja cobrança de pagamento está suspensa, acesse o Dashboard, clique no botão "Filtrar" no canto superior direito, selecione o "Status da cobrança" ("Cobrança suspensa") e clique em "Concluído". 

Você pode exportar um CSV com essas assinaturas clicando no botão "Exportar". Também é possível encontrar essas assinaturas na API ao analisá-las com um valor diferente de nulo para pause_collection.behavior. 

A API Customer Portal Configuration vai mudar?

Se você já usou o recurso de suspensão de assinatura no portal do cliente, ainda poderá transmitir `features.subscription_pause` ao criar uma configuração do portal do cliente. 

Porém, ele só será ativado se o cliente puder retomar a cobrança de pagamento de uma assinatura no portal do cliente. Os clientes não poderão suspender a cobrança de pagamento no portal do cliente. 

Além disso, o parâmetro da API será removido totalmente até 1º de agosto de 2024. Nessa data, a transmissão do parâmetro features.subscription_pause retornará um erro. 

É preciso atualizar as integrações que usam esse parâmetro antes de 1º de agosto de 2024 para evitar erros.

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

Para usuários que ativaram a opção "Suspender assinatura" no portal do cliente, os clientes não poderão mais retomar uma cobrança de pagamento de assinatura suspensa a partir de 1º de agosto de 2024.

E se eu precisar de uma solução para permitir que os clientes suspendam as assinaturas antes que a Stripe aceite a suspensão de assinaturas?

Atualmente, a única opção é desativar a cobrança de pagamento diretamente pelo Dashboard ou pela API e disponibilizar os serviços com base no campo pause_collection quando o webhook atualizado da assinatura do cliente for enviado. O status da assinatura permanecerá ativo, então você precisará monitorar manualmente se os serviços deverão continuar ou ser suspensos para esses clientes.