Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
Visão geral
Billing
Visão geralSobre as APIs do Billing
Assinaturas
    Como funcionam as assinaturas
    Início rápido
    Casos de uso
    Crie sua integração
      Crie uma integração de assinaturas
      Crie uma integração de assinaturas
      Integração com o Salesforce
      Definições de evento de assinatura
    Recursos de assinatura
    Direitos
    Análises
Invoicing
Cobrança por uso
Cotações
Gerenciamento de clientes
Billing with other products
Recuperação de receitas
Automações
Reconhecimento de receitas
Teste sua integração
Tributos
Visão geral
Use Stripe tax
Manage compliance
Relatórios
Visão geral
Selecionar um relatório
Configure reports
API de relatórios
Relatórios para várias contas
Reconhecimento de receitas
Dados
Visão geralEsquema
Relatórios personalizados
Data Pipeline
Gerenciamento de dados
Página inicialReceitaSubscriptionsBuild your integration

Como criar uma integração

Saiba quais opções você precisa fazer para integrar assinaturas ao seu negócio.

Antes de começar a criar sua integração de assinatura, escolha o caminho de integração correto, especialmente se não estiver escrevendo o código sozinho e precisar de colaboração com terceiros. Use este guia como ajuda para decidir a melhor maneira de criar sua integração e siga os links para guias de passo a passo detalhados.

Este guia é para usuários que não estão necessariamente escrevendo código, mas que desejam aprender sobre o processo de integração de assinaturas para que possam criar planos e organizar recursos.

Se você já sabe como vai criar sua integração ou se quer começar a programar imediatamente, consulte o nosso criador de integrações.

Modelos de assinatura

Você precisa entender os modelos de assinatura disponíveis para ajudar a fazer escolhas posteriores, como o modelo de preços e a forma de pagamento a ser usada. Primeiro, considere seu modelo de negócios:

  • Se você quiser que os clientes paguem, provisione acesso ao seu serviço. Clique na guia Pagamento antecipado abaixo para saber mais.
  • Se você quiser coletar dados de pagamento e oferecer aos clientes um período de avaliação gratuita antes de cobrá-los, clique na guia de avaliação gratuita abaixo para saber mais.
  • Se você quiser fornecer aos usuários acesso ao seu serviço sem solicitar nenhum dado de pagamento (um modelo freemium), clique na guia freemium abaixo para saber mais.
Modelo de assinatura com pagamento adiantado

Modelo de pagamento adiantado

No modelo de pagamento adiantado, você coleta dados de pagamento e cobra os clientes antes de provisionar o acesso ao serviço. Após a cobrança inicial, você continua cobrando os clientes o mesmo preço fixo pelo mesmo serviço em intervalos regulares. Nesse modelo, você usa o Dashboard ou a API Subscriptions para gerenciar as assinaturas dos clientes. Para permitir que os clientes modifiquem suas assinaturas diretamente, você precisa integrar o portal do cliente.

Por exemplo, uma empresa de hospedagem de fotos que oferece níveis de serviço básico e premium e cobra os clientes mensalmente pode ter a seguinte configuração:

  • Um produto para a opção básica
  • Um produto para a opção premium
  • Um preço para a opção básica (15 USD por mês)
  • Um preço para a opção premium (25 USD por mês)

Um fluxo típico para esse modelo seria assim:

Mais sobre webhooks no fluxo

Na etapa 3, o evento específico que você está procurando se chama checkout.session.completed. Se estiver usando o Elements, conceda acesso após receber um evento invoice.paid.

Na etapa 4, procure um evento chamado invoice.paid.

  1. O cliente escolhe o plano (básico ou premium).
  2. Você coleta dados de pagamento.
  3. Você concede acesso ao seu serviço. Você sabe quando fazer isso monitorando eventos de webhook.
  4. Você continua concedendo acesso aos clientes pela duração da assinatura. Verifique regularmente para assegurar que não está concedendo acesso se o pagamento de um cliente falhar.

Consulte o guia de integração para saber como criar uma integração com uma abordagem low-code que utiliza uma página pré-criada e hospedada do Stripe Checkout ou uma versão personalizada com o Stripe Elements.

Faturamento por consumo

Se você precisa medir consumo, consulte o faturamento por consumo. É preciso fazer isso quando ao criar um preço.

Coletar dados de pagamento

Se você não quer usar muita programação, use o Checkout, a página de pagamentos pré-integrada e hospedada pela Stripe. Consulte o guia de integração das assinaturas com o Checkout para começar a usar.

Se você quer um formulário de pagamento mais personalizado e incorporado a um site existente, use o Elements, um conjunto de elementos de IU pré-integrados que faz parte do Stripe.js.

Exibir informações de preço

Incorpore uma tabela de preços ao seu site para exibir informações de preço de assinaturas aos clientes. Quando escolhem uma opção de assinatura, os clientes são levados ao checkout. Configure, personalize e atualize preços no Dashboard sem precisar de programação.

Modifique assinaturas

Se você coleta dados de pagamento com o Checkout, pode usar o portal de clientes para permitir que os clientes atualizem diretamente os dados da assinatura, como forma de pagamento e frequência. Consulte o guia de integração para obter instruções detalhadas sobre essa configuração. (Antes da integração, você também deve estar ciente das limitações do portal).

Se você está usando o Elements na integração, pode adicionar um formulário no front-end para coletar os dados do plano que o cliente quer alterar (como ID do preço e dados do cliente) e enviá-los a um endpoint no back-end. Para ver mais detalhes e exemplos de código, consulte a seção sobre alteração de planos pelos clientes no início rápido do Elements.

Modelos de preços

Se você fornece o mesmo produto todos os meses e não espera que haja alteração, use um modelo de preço fixo. Se o preço variar dependendo do número de usuários ou unidades, use preços por volume ou por nível. Para ver uma lista completa de modelos disponíveis e uma descrição detalhada de cada um deles, consulte os exemplos de modelos de preços.

Configurar webhooks

Configure endpoints de webhook para receber notificações sobre eventos relacionados a assinaturas. Por exemplo, quando você recebe a notificação invoice.paid=true, é seguro provisionar acesso ao seu serviço. Consulte o ciclo de vida da assinatura para obter mais informações sobre eventos de webhook. Veja uma lista completa de eventos relacionados a assinaturas. Para saber mais sobre como gerenciar o acesso ao recurso do seu produto, consulte Direitos.

OpcionalOutras considerações

Esta página foi útil?
SimNão
Precisa de ajuda? Fale com o suporte.
Participe do nosso programa de acesso antecipado.
Confira nosso changelog.
Dúvidas? Fale com a equipe de vendas.
LLM? Read llms.txt.
Powered by Markdoc