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
    Visão geral
    Como funcionam as assinaturas
    Comece já
    Início rápido
    Planejar uma integração
    Criar uma integração
    Casos de uso
    Sobre assinaturas
    Ativar o modo de faturamento
    Definições de evento de assinatura
    Direitos
    Faturas de assinatura
    Cronogramas de assinatura
    Modelos de preço recorrente
    SCA (autenticação forte de cliente)
    Configurar assinaturas
    Configurar métodos de cobrança
    Incorporar uma tabela de preços
    Defina ciclos de faturamento
    Gerenciar assinaturas
    Migrar assinaturas para a Stripe
    Set product or subscription quantities
    Assinaturas de intervalo misto
    Inicie assinaturas com data passada
    Definir períodos de avaliação
    Lidar com assinaturas com pagamento diferido
    Aplicar cupons
    Modifique assinaturas
    Gerenciar formas de pagamento de assinatura
    Análises
    Manage subscriptions on iOS
Invoicing
Cobrança por uso
Cotações
Gerenciamento de clientes
Cobrança com outros produtos
Recuperação de receitas
Automações
Teste sua integração
Tributos
Visão geral
Usar Stripe Tax
Gerenciar conformidade
Relatórios
Visão geral
Selecionar um relatório
Configurar relatórios
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 inicialReceitaSubscriptions

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.

Cobrança por uso

Se você precisa medir consumo, consulte a cobrança por uso. É preciso fazer isso quando você cria 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 webhook para receber notificações sobre eventos relacionados à assinatura. Por exemplo, ao ver a notificação invoice.paid=true, você pode usar direitos para provisionar acesso ao seu serviço. Consulte o ciclo de vida da assinatura para obter mais informações sobre eventos de webhook.

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